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1, Introduction 

The supervisory system MOLD is designed to enable a 
number of systems-programmers (perhaps a dozen) to debug 
their programs simultaneously; Each user will have" the 
freedom of hands-on debugging, and the convenience of 
teletype control from remote locations. 

MOLD uses a GE 625/635 configuration, with communication 
controlled by a local Datanet-30. Input from teletypes is 
either directly to this D-30, or chanelled via a remote 
D-30. 

To connect to MOLD, one calls the D-30 from a teletype. 
When the phone is answered, an identification may be obtained 
by a WRU (control-E). Communication beyond this point is by 
a one~line-at-a~time command system (except when building 
files, see EDIT), waiting for system response, before the next 
command. Each of these must be addressed to one of the four ' 
operating systems s. GMAP (for compiling), LOADER (for 
obtaining a core-image of a compiled program), EDIT (for file*- 
manipulation), and DDT (for debugging). These are explained 
in detail below. 

The following information is generally useful. One must 
start by typing v 

RUN XXXX 

where XXXX is the name of one of the four systems. GMAP and 
LOADER accept only a single command. (To reuse them, a new 
RUN is needed.) However, EDIT and DDT permit conversations, 
hence they are available to the user until he types EXIT. 

File names and passwords (which are optional), have up to 
eight characters (letters and digits only), and they are 
recorded left-justified, filled with, blanks. 

Certain teletype keys play special roles s Back-arrow 
or control-H erases a character, control-X deletes a line, 
and the break key may be used to abort a job (e.g. stop output). 
In the initial phase of the system it would be a good idea for 
the user to push the break key before typing RUN for the first 
time< to wipe out any incomplete jobs associated with his tele- 
type. 

When finished, the user should type TERMINo 
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2. GMAP 

After the user has typed RUN GMAP, the system will 
return GMAP HERE when ready. The user will then type an 
input line of the following forms 

SOURCEPILE (, password)? LISTFILE (, password)? BINFILE (,p)? 
ERRFILE (,p) (cr) 

LISTFILE, BINFILE, and ERRFILE stand for the three output 
files - listing file, binary deck file, and error file. If 
these are not to be outputted, nothing should be inputted 
in their place in the input line*. Thus 

SOURCE ?? ?ERRFILE , password 

would output only the error file. Files used in GMAP must 
have been previously saved by the user through EDIT, The 
error file will contain the line numbers of the incorrect 
"cards" with the error flags, the cross«=reference table, and 
the undefined symbol listo To use GMAP again after the line 
has been inputted, the user must again type RUN GMAP* The 
system automatically exits from GMAP after each operation . 

GMAP assumes that the file to be compiled has line 
numbers o These may be supplied by means of EDIT* 



LOADER ' 

The purpose of the LOADER is to convert a card image file 
to a core image file. After typing 

RUN LOADER 

the system will return 

LOADER HEREo YOUR MOVE* : 

Then, as in GMAP, .the, user inputs one line 

FILEOUTs SYMFILE? MAPFILE? FILEl?— ? FILEn 

where SYMFILE and MAPFILE are optional and may be omitted by 
two semi-colons in a row as in GMAP. SYMFILE stands for symbol 
table and MAPFILE for memory map. Thus the LOADER takes 
FILEl, — , FILEn and converts them to binary images and puts 
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them into a single FXLEOUTo The output then is the core 
image, FILEOUT, .and the optional reshuffled symbol table 
and memory map. Passwords may be used, as in GMAP, and all 
files must have been previously saved. The system auto- 
matically exits from LOADER after the completion of the job. 
GMAP and LOADER also automatically SAVE and CLOSE the files 
used-.in. their operations^- . "' .... "• ■'■'.;.'. :";; ^^ci^'v- •■' '• 



EDIT 

The object of EDIT is to maintain and make changes in 
the source files. After the typing of ' 

RUN EDIT - . 

the system will return 

EDIT HERE 

when EDIT has been loaded. - ^ne user can then give any one 
of several commands . The system will remain in EDIT until 
the user types EXIT as a commando EXIT automatically 
releases all active files . 

Only one file with a given file name can be active at 
once. Thus, two files with identical names but different 
passwords cannot be active at the same time. Passwords,, if 
used, are needed only with the commands OLD, SAVE, and UNSAVE 
The EDIT commands and their descriptions follow. Several 
files can be active at once, so each command requires a file 
name. 

NEW FILENAME 1; FN2; .00 

creates a new scratch file for each name given. 
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OLD FILENAME , password 7 

recalls previously used and saved files, needs the 
password used when last saved. 
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UNSAVE FILENAME, password; 

destroys permanent files. Files must be inactive at. 
the time . 
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RENAME OLDNAME? NEWNAME? OLD; NEW? 

renames OLD file with NEWNAME, inactivates OLD file. 

RELEASE FILENAME? FN? o... 

inactivates as many files as you name. Passwords not 
necessary. 
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SCRATCH FILENAME 3 

destroys temporary copies of files named, name remains 
available for use. 
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SAVE FILENAME, password? 

catalogs files, password needed to get file back. It 
is not possible to SAVE a file if there is already a 
filename v/ith that password SAVED. It must first be 
UNSAVED, if you wish to replace it. 



BUILD FILENAME 

Normally the user is allowed to type only one line at 
a time,, and must then wait for the system to respond. This 
is clearly inconvenient for building files. The command 
BUILD, issued to EDIT, allows the user to type in a large 
number of lines, without waiting for system response. These 
lines are added to the file he is building. Clearly only 
one file can be built at a time, hence BUILD has a single 
filename as argument. When the building operation is 
completed, the user types a blank line (i.e. hits the carriage 
return an extra time). The system will respond READY. Then 
he can issue a new command to EDIT. 

There is a limit of 2000 characters in one BUILD. 
Since this represents over 5 minutes of typing, at maximum 
teletype speed, this is not a serious restriction. In any 
case, though a vacuous carriage return must occur no later 
than the 2000th character, the user may then type BUILD, 
and continue building his file. 

To make changes, in a 'file the fo3,16wing procedure must -be 
used. 

OLD A 
BUILD A 

RENAME A?B 
UNSAVE A 
RENAME B?A 
SAVE A 

This procudure will be simplified .later. 
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The following EDIT commands are similiar to the EDIT 
commands in the present Time-Sharing System. 
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APPEND FILE^l ; FILE J? 

All files are added to the end of the previous file 
and the resulting file is called FILE$1. • 

SORT FILENAME 

Only one file name is given. The line numbers are 
sorted and only the last one appears in the file. Thus 
if there are two lines with number J>kO, only . the last 
*' one will appear in the resulting file. A file can 

contain no more than 409^ lines, and if no line number 
is given it will be considered as line 0. 

SEQUENCE FILE? A,B 

Puts line numbers in the file. The original file need 
not have line numbers. The first line number will be 
A with the increment equal to B. ■■ If A and B are not 
given,. A will be 100 and B will be 10. The only legal 
line numbers are 0..- 2-1. 

LIST FILE? A,B, C-D, .... 

will list file with lines in the order given. If no " 
parameters are given, a forward list will be given. In 
a select list, the lines must be in the first 409^ lines 
of the file. There is no restriction on a non-select 
list. 

DELETE and EXTRACT 

are the same as in the present EDIT system. The format 
is the same as LIST. The parameters must be given in 
increasing order. 



DDT 

DDT, like EDIT, can do. several operations and depends 
on the instructions' given to it. Like EDIT, you must type 
"EXIT" as a command to get out of DDT. The purpose of DDT 
is three-fold. 
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1) Trace a program by printing out the contents of 
selected registers or memory locations, at selected 
times during a RUN of the program. 

2) Patch any desired corrections or changes '. into any 
location in the assembled program. This can be 
done without reassembling the program and can be 
written in the source language of the program. 

5) Embed "breakpoints ,: ' in the program. The message 

"BREAKPOINT AT LOCATION. XXXXX" / is then printed out. . . 
The user may then make changes, have memory or 
registers printed out, or may simply resume execution. 

In DDT, the format of a number" .specifies its type. Thus, 
64 octal, 64. is decimal, and 64.0 is floating point. 

To allow more than one DDT command on -..a teletype line, ■ 
ffi. is used as a substitute for c.r. .Thus, several commands 
separated by ^' s may be typed on a line. ' A description of. 
the DDT commands follows. 

LOAD Filename, Password; SYMFILE, Password?^ 

A file and its symbol table file created by the loader 
are loaded into memory. The loader must always be used 

first to create a core image file of all the programs you 

want to run under DDT. 

FORMAT Mode ^ 

All output will be given in that output mode, with one 
exception. If a command is preceded by an output mode 
symbol, the output for that single command will be in 
the specified mode. The available output modes are: 

SYM Symbolic Mode. The contents of the location are 
printed as a mnemonic operation code followed' by a 
symbolic address and as address modification field. 

•*■ 
DEC Decimal Mode. The contents of the location are 
printed as a fixed-point decimal constant. 

OCT Octal Mode. The contents of the location are 
printed as a fixed-point octal constant. 

FLO Floating point Mode. The contents of the location 
are printed as a floating point constant. 



BCD Binary Coded Decimal Mode. The contents' of the 
location are printed as 6 alpha-numeric characters of 
6 bits each. 

ASC ASCII Mode. The contents of the location are 
printed as 4 alpha^numeric characters of 9 bits each. 

HAL Half-word Mode. The contents of the .location are 
printed as two symbolic address expressions (18 bits each) 

TAL Tally Mode.. The contents of the location are ■•• 
printed as a symbolic address, a tally count, and 6 
modification bits which will be printed as 2 octal digits. 

DUMP Address List 'if 

Each element of the address list is either a -single 
address or a pair of address expressions separated, by 
a comma. The elements of the address list are separated 
by semi-colons. The contents of these locations are 
printed out. 

PATCH Single address Expression; List of Word Expressions . r y^ 
The word-expressions, which are separated from each 
other by semi-colons, replace the contents of sequential 
memory locations at the address given in the first 
argument. 

BREAK A(l),l(l),L(l)u(l); A(2), ...... ^jb 

A single BREAK command can embed several breakpoints. 
Each breakpoint has from 1 to 4 arguments. Different 
breakpoints are separated by semi-colons. 
The first argument, A(n), is the address at which . the 
the breakpoint is inserted. If A(N) is the only argument 
supplied, the program halts, the breakpoint message is 
printed out, and further instructions are awaited. The . 
instruction in the location where the breakpoint is 
inserted is not executed before the BREAK takes place. 
If X(n) is also supplied, the breakpoint will be ignored 
l(N) times. If it is not 'specified, it will automatically 
be 0. 

If L(N) is supplied also, the contents of location L(N) 
will be printed out along with the breakpoint message. 
If U(N) is also supplied, L(n) specifies the lower bound 
of the block 'of memory to be printed out. u(n) is the 
upper bound. 
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Breakpoints cannot be placed in the following locations 

1) Program modified locations, 

2) Instructions to be executed by a XEC or XED. 



UNBREAK . Address. List :#* 

The address list may be omitted or may contain any 
number of single addresses separated by semi-colons* 
The breakpoints at these addresses are removed. If no 
list is given all the breakpoints are removed. 



'CONTINUE I(N) ^ 

Execution of program resumes. The next instruction 
executed is the. instruction at the breakpoint location. 
If l(N) is supplied, it replaces the l(N) for this 
breakpoint, 

TRANSFER Single Address Expression *r? 

Execution of program commences, or resumes at location 
given. This must be given to start a jprogram. After 
a breakpoint, control can be transferred to any location 
desired. 



REGISTER ■ Optional List of Register Identifiers i& ' ■ 
The argument' list, if supplied, is a list of register 
identifiers separated by semi-colons. The contents 
of these registers will be printed out. If no arguments 
are given, all registers will be printed out. The 
index registers are specified by a number only, ,not XN« 



ALTER Register Identifier, Expression;... y^ 

The contents of each register specified are replaced ■ 
by the corresponding expression. 



SAVE Program Name ^r 

The program, or programs, currently loaded are saved 
under the name supplied. All breakpoints, patches, 
ect, are • preserved as they stand. 
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M3LD 
USER MANUAL- . 
SUPPLEMENT N0, 2 — 0CT . 8,1966 



M0LO. HAS N0W RUN SUCCESSFULLY IN 30TH R0ME AND PHE0NIX. IN 
FACT., BILL ADAMS REP0RTED HE G0T 4 DAYS W0RK D0NE IN SEVERAL 
H0URS USING M3LD. HE SAYS T0 C0UNT HIM AS AN ENTHUSIASTIC 
M0LDY SUPP3RTER. 



.3 SUPPLEMENT C0NTAINS S0ME WARNINGS CONCERNING C: 
WHICH WERE EXPLAINED IN PREVIOUS M0LDY COMMUNICATIONS. ALS0. 
SEVERAL NEW COMMANDS HAVE BEEN. ADDED T0 M0LD SYSTEMS. THESE 
NEW C3MMANDS ARE EXPLAINED 3EL0W. 



^0LD EDIT PACKAGi 



3UILD F 



WARNING: A MAXIMUM OF 1024 CHARACTERS CAN BE APPENDED T0 
FILE F WITH 3NEUSE OF THE 3UILD COMMAND. IF YOU NEED 
T3 APPEND M3RE THAN 1024 CHARACTERS YOU MUST EXIT BUILD 
M0DE PRIOR T3 THE TYPING' 0F THE 1024TH CHARACTER AND 
THEN ISSUE ANOTHER BUILD C0MMAND. 



APPEND F1;F2: ... ;FN 



N3TE: IN AN APPEND COMMAND THE SEC0ND ■ OCCURRENCE 0F THE 
FIRST FILE Fl REFERS TO THE FILE AS MODIFIED BY THE 
APPEND COMMAND UP T.0 THAT P0INT. F0R EXAMPLE, THE 
COMMAND ■'. 

APPEND A,3,C,A 

RESULTS IN THE FOLLOWING SEQUENCE 0F OPERATIONS 
i FILE B IS APPENDED TO FILE A GIVING A+B 

2 FILE C IS APPENDED T0 FILE A+B GIVING A+3+C 

3 FILE A+o+C IS APPENDED T3 A+B+C GIVING A+B+C+A+3+C 
AS THE FINAL RESULT. THE RESULTANT . FILE HAS THE NAME A 
AND REPLACES THE PREVIOUS CONTENTS 0F A. 



MOLD DEBUGGING PACKAGE 



EXTEND E# 



THE EXTEND COMMAND IS USED FOR SETTING THE MEMORY BOUND 
0F. THE PROGRAM BEING DEBUGGED. EXTEND TAKES ONE 
ARGUMENT WHICH IS AN EXPRESSION REPRESENTING- THE FIRST 
C0RE LOCATION N0T REFERENCED BY THE PROGRAM. THE 
DEBUGGING SYSTEM WILL REJECT ANY EXECUTIVE COMMAND T0 
THE MOLD FILE SYSTEM THAT REFERENCES MEMORY NOT IN THE 
PROGRAM'S BOUND.' ALSO THE USER MAY NOT PATCH 0R DUMP 
MEMORY NOT IN HIS PROGRAM'S BOUND. THE MEMORY BOUND IS 
ALSO CHANGED BY THE LOAD COMMAND TO POINT TO THE FIRST 
LOCATION NOT USED BY THE CORE IMAGE PROGRAM. THE SAVE 
COMMAND ALSO MAKES USE OF THE MEMORY BOUND IN THAT IT 
ONLY SAVES THAT SECTION OF CORE WITHIN THE USER'S 
BOUNDS. 



ZERO Ml ,N1 ,E1;M2,N2,E2; . . . ;MJ ,NJ ,EJ# 



ZERO IS USED FOR SETTING A BLOCK OF MEMORY TO A 
CONSTANT. WHAT ZERO DOES IS SET THE BLOCK WHOSE LOWER 
ADDRESS IS M AND WHOSE UPPER ADDRES IS N TO E. IF E IS 
MISSING THEN THE BLOCK BETWEEN M AND N IS SET. TO ZERO. 
IF BOTH N AND E ARE MISSING THEN JUST THE SINGLE 
LOCATION M IS SET TO ZERO. 



MERGE F1;F2; 



;FN 



THIS COMMAND MERGES FILES F2 THROUGH FN INTO FILE Fl . 
THE KEYS USED IN THE S3RT ARE I) THE ORDER IN WHICH THE 
FILE NAME APPEARED IN THE MERGE COMMAND, AND 2) THE LINE 
NUMBER OF THE LINE IN THE FILE, S0 A LINE CL,F) , WHERE 
L IS THE LINE NUMBER AND F IS THE FILE NAME, WILL 
PRECEDE A LINE CM, A) IF L<M 0R IF L=M AND F OCCURRED 
BEF0RE A IN THE MERGE COMMAND. 



WEAVE Fl: F2; 



;FN 



THIS C0MMAND IS EQUIVALENT 
F0LL0WING TW3 C0MMANDS: 

1 APPEND F1;F2; ... ;FN 

2 S0RT Fl 



T0 THE EXECUTION 0F THE 



'-DDR ESS M0DE# 



ADDRESS IS USED T3 SET THE ADDRESS 
ARGUMENT WHICH MUST 3E 0NE OF: 



MODE. IT TAKES ONE 



i) OCTAL ADDRESSESCPRINT AS 6 DIGIT OCTAL NUMBERS) 

2) DECIMAL ADDRESSESCPRINT AS DECIMAL NUMBERS) 

3) SYMBOLIC ADDRESSESCPRINT AS SYMBOL + A CONSTANT) 

SYMBOLIC, WHICH ISN'T IMPLEMENTED YET, WILL BE NORMAL 
MODE. HOWEVER, UNTIL SYMBOLIC MODE IS WORKING, OCTAL 
MODE WILL BE THE NORMAL MODE. 



OPTION 0PT1 ;0PI2; ...;0PTJ* 



FAULTS. 



IS USED T3 SET 
THE FOLLOWING 



THE DEBUGGER'S METHOD OF HANDLING 
0PTI3NS ARE AVAILABLE 



MEMORY; 
MME;N3M 
FAULT; N 
TIMER ;N 
COMMAND 
DERAIL; 
LOCKUP; 
CONNECT 

PARITY; 
ZERO; NO 
ONCtNOO 
STARTUP 
OVER FLO 
DIVIDE; 
EXECUTE 
MOLD; NO 



N3MEM0RY 

ME 

3FAULT 

3TIMER 

;NOC0MMAND 

NODERAIL 

N0L0CKUP' 

;N0CONNECT 

NOPARITY 

ZERO 

NC 

rNOSTARTUP 

W; NO OVER FLOW 

NODIVIDE 

rNOEXECUTE 

M3LD 



MEMORY FAULTS RETURNED. 
MME'S AND FILE CALLS. 
FAULT TAG FAULTS RETURNED. 
TIMER RUNOUT FAULTS RETURNED. 
COMMAND FAULTS RETURNED. 
DERAIL FAULTS RETURNED. 
L0CKUP FAULTS RETURNED. 
CONNECT FAULTS RETURNED. 
PARITY FAULTS RETURNED. 
ZERO OP FAULTS RETURNED. 
OP NOT COMP. FAULTS RETURNED. 
STARTUP FAULTS RETURNED. 
OVERFLOW FAULTS RETURNED. 
DIVIDE CHECK FAULTS RETURNED. 
EXECUTE FAULTS RETURNED. 
MME'S GIVEN TO THE MOLD EXEC. 



THE NO OPTION ASKS 
OPTION 3E TURNED OFF. 
SHOULD ALL OPTIONS 
UNDER THE DEBUGGING 



THAT THE SPECIAL FAULT HANDLING 

NORMAL MODE IS ALL OPTIONS OFF. 

BE TURNED ON THEN ANY PROGRAM RUN 

SYSTEM WILL RECEIVE FAULTS AND 



HANDLE FILE CALLS EXACTLY AS IF UNDER THE MOLD EXECUTIVE 
DIRECTLY. THE ONLY FILE CALL THAT IS NOT SIMULATED IS 
THE "GETCAT" CALL. FAULTS ARE RETURNED IN THE SAME 
MANNER AS THE MOLD EXECUTIVE. 



TILE CALLS--- 



THE DEBUGGING PACKAGE ALSO ALLOWS THE USER T0 TYPE IN AS 

COMMANDS FILE CALLS T0 THE MOLD. EXECUTIVE. THESE CALLS 

WILL BE EXECUTED EXACTLY AS IF THE USER'S PROGRAM MADE 
THE CALL ITSELF. THE AVAILABLE COMMANDS ARE 



READ FPU ,M1 ,N1 ;FR2,M2,N2 . 

APPEND FK1 ,M1 ,N1;FR2,M2,N2 

REWIND FR1;FR2 

SCRATCH FR1;FR2 

CLOSE FR1;FR2 . 

DESTROY FR1 ,NAME,PSW; ... 

CATL0G FR1 ,FR2 , NAME ,P.SW; .. . 

OPEN FK1, NAME, PSW; ... 0R OPEN 



IN THOSE COMMANDS REQUIRING A PASSWORD f - IF THE PASSWORD 
IS MISSING THEN NO PASSWORD (A PASSWORD 0F ZERO) IS 
ASSUMED. IF THE FIRST CHARACTER 0F THE NAME OR PASSWORD 
IS A SLASH, THEN THE REMAINING CHARACTERS 0F THE NAME OR 
PASSWORD ARE ASSUMED TO BE OCTAL DIGITS WHOSE VALUE WILL 
BE USED IN PLACE OF THE ASCII NAME OR PASSWORD. A. 
SPECIAL CASE IS' THE OPEN COMMAND. IF ITS ARGUMENTS ARE 
NULL THEN IT OPENS A SCRATCH FILE. OTHERWISE IT OPENS 
THE FILE WITH SPECIFIED. NAME AND PASSWORD FROM THE 
CATLOG SPECIFIED- IN FILE REFERENCE NUMBER. ON THE 
INITIAL 'MOLD SYSTEM THERE IS ONLY ONE CATALOG AND ITS 
FILE REFERENCE NUMBER SHOULD BE 1 . 
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MOLD INTRODUCTION 




IF ■ HE DOES '.MfTT TYPE "HELLO" HIS- CONSOLE WILL" 
EE DISCONNECTED AEP THE PUOAJE WILL BE HIK-IG U? AFTER 
USE'v HAS TYPED IM "HELLO" MOLD WILL TYPE OUT ' •" 
"USEE DUMBER " . THE USEE . WILL AGAIN BE GIVE-?! . . 



"TUT? 



DrnT ,-< n t <-« p ;- r- 1 n> ;'i c r ' a o •? c; p ;'< <■:, p ;r T 17 T f-i 






A VALID -USEE ;;UMBER THE V:0?r> "EEADY" WILL ES TYPED- BY TiOL'D. 
AT THIS POIOT THE USEE CAM REQUEST THAT AMY SYSTEM ■ 
•AVAILASLE UMDHE MOLD EE RUO, THE REQUEST IS MADS- SY TYPING- 
"R !.![!" FOLLOWED BY THE- UAME OF THE SYSTEM WHICH IS .TO BE. RUM 
FOE EXAMPLE/ A REQUEST TO RUM GtfAP' WOULD BE EUTEEED AS . . 
FOLLOWS? "E!K! GMAP'V THE TTH'ER STANDARD COMMAUD- 
^)UCM MOLE WILL RECOGNIZE IS "GOODBYE"- WHICH .WILL HAVE THE 
.SAME EFFECT AS IT DOES flf-J THE DARTMOUTH Tli-'JU! SHARING 
OYSTEN ... YOU WILL BE LOGGED OUT THE 'HOLD EXECUTIVE ' ?!'3R 

•"^ r~ .^* ^. /"» * i i* t r-» >^» .v mi \ # t» t f n r< n /-\ /•-•*' .■ .-,*•. t \> r~ ¥■ i ? r- » t • /^ii iin itm */ti a ^ • r> lift /•• «r\ ri 
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THE "ALT MODE" AS THE TWO LOCAL ' EDITING CONTROL CHARACTERS 
EVENTUALLY- SYSTEMS SHOULD BE AELE TO SUPPRESS THE LOCAL 
EDITING 0PTI0M, , 



IM SUMMARY, MOLD WILL HAVE THi 

COMMANDS 

HELLO 

RUM XXXXX- 

GOODBYE 



FOLLOWING FEATURES 



o <■>. /: 



■p <~ «'~ 

?> 92 
0. .94 

PC) '7 

■300 
30£ 
303 

30.'! 

30 e 

308 
310 
3 15 
316 
3?.0 
330 
340 



LOCAL EDITING 

"PACK ARROW" DELETES OWE CHARACTER 
' "ALT' MODE." DELETES THE 'LINE 

PAiJIC 

BREAK CHARACTER WILL ABORT A JOB. 

SYSTEMS AVAILABLE ' 

GMAP 
-. GL'flAD 
DDT 

EDITOR 



SEE THE FILE. WITH THE GAME NAME AS THE SYSTEM FOR 
A DESCRIPTION OF THE SYSTEM. 



.LIST 



MM I 

10 
20 
30 
100 

no 

120 
130 
140 
150 
160 
170 
180 
1 90 
200 
210 
.220 
230 
240 
250 
260 
270 



IIT 16:48 JUNE 30.,1S>66 

LAST CHANGE 1-110, 2A/6/SS (KML) • . 

PHASE A FILE IMPLEMENTATION . ' ' 

INITIALLY MOLD WILL HAVE ONLY ONE 'MASTER CATALOG AMD'. . 
AMD ALL CATALOG ACCESSES WILL BE DONE I N ■ THIS CATALOG . '. ' 
NAMES- OF FILES WILL-' CONSIST- 0F 2 36-BIT WORDS AND PASSWORDS 
MIST BE A HALF-WORD QUANTITY SINCE THEY ARE TRANSMITTED TO THE 
EXECUTIVE THROUGH AN INDEX REGISTER. INITIALLY ONLY 
THE FOLLOWING FILE COMMANDS WILL BE AVAILABLE;. 

OPEN T S FR,.NA'ME 5 PASSWORD . ■''.','••' .. 

17 A- SCRATCH FILE IS DESIRED. USE THE NAME (0,0) 
I.E. A DOUBLE LENGTH ZERO.' SINCE THERE IS ONLY 
ONE CA'TAUOG THE' FILE REFERENCE NUMBER FR IS . 
REDUNDANTCIN FACT. MEANINGLESS) BUT IT SHOULD 
BE USED IF- ONLY TO REMIND .YOU THAT IT'. WONT BE LONG 
BEFORE Y0U HAVE TO SUPPLY THE FILE REFERENCE 
NUMBER OF A -CATALOG FILE, . ■' . 



290 
300 
510 
320 
33 
340 
350 
360 



CATALOG T«FR,FR.F-,A 



, i , 



THIS 'COMMAND WORKS A3 DESCRIBED EXCEPT THAT THE FIRST 
FILE REFERENCE NUMBER (WHICH SHOULD " REFERENCE A CATALOG) 
IS MEANINGLESS AND THAT THE ACCESS LOCKS ARE ALSO NOT 
USED BY THE EXECUTIVE. ■ ' 



3:70 

3 90 

4 00 
4 10 
420 
430 
.440 
450 
460 
4 70 
4o0 



DESTROY T,.FR,F 



THIS COMMAND ALSO WORKS AS DESCRIBED .EXCEPT 
THAT THE FILE REFERENCE NUMBER IS NOT USED. 



THE' REMAINING COMMANDS WHICH WILL BE AVAILABLE 
INITIALLY WILL WORK AS DESCRIBED AND THEREFORE AR 
ONLY LISTED HERE.' 



Y. , 



a LI ilt ij/ !i 3 • .• ? i'i 



"j ::> u 
560 
570 
3 r '0 
5 '*•' 

/" i~< r\ 



APPEND T 5 FR 3 N 5 M 



REWIND T FR 



r 'f"~"' ATf"'- f T i?P . 

..•Ui..-iib(i i , ]' i\ 



OLD 

OLD PROBLEM NAME — MFCS. 

READY. 

LIST 



MFC.' 



iOO 
110 
120 
130 
140 



160 

170. 

1R0 

190 

200 

210 

99. Q 

UN.' '.-' 

240 
250 
2 SO 
270 

2 BO 
290 
300 

3 10 
320 
33 
340 
330 
360 

3 70 
3K0 
390 
400 

4 10 
420 
430 
440 
430 
4 SO 
^70 
480 
4 90 
500 
510 
520 
530 



11:34 J.UHE 24, 1966- 
LAST CHANGE HERE? 1525,'. 23/G/SG [TR'J] 

»>CL^SE T,FR . 
»>»OPEN. ,T,FR,F 
»>»>>0PEM ' T •. 
»>»»»READ T ? FR,M,r ; l ;• 
>>»>>>>>>>REViMD ■ T,FR 
■»>»•> >-»>»>SK IP" J^FR,;) 
>»>»>>>»CAILOG T,FR,FR,F,A- 
>»»'»»REPLAC T,FR,FR,F,A 
>»>>»DESTR0 T 5 FR,F 
>»»APPEMD T,FR, W ? tf 

T 



M0TATI0M: 

T: TRAP PROGRAM LOCATION 

FR: FILE REFERE?>!CE NUMBER _ 

F: ■ FILE IDENTIFIER .(0F VVWi <=FILENAME, PASSWORDS 

Ms ' "NUr^ER OF V/0RDS CAR ENTRIES) 

M: MEMORY L0CA7I0N 

A: ACCESS PROHIBITIONS 



LIST 



MFT 

100 

■102. 

104' 

106 

108 

110 

112 

114 

116 

US 

120 

122 

124 

126 

127 

128 

130 

135 

13S 

140 

142 

144 

146 

148 

150 

152 

154 

156 

158 

160 

162 

164 

166' 

168 

170 

178 

180 

1S1 

182 

1S4 

13$ 

153 

189 

190 

192 

194 

195 

196 

1 0*7 



17:05 



JUNE 24 , 1966 



MOLD FILE SYSTEM 

TERMINOLOGY : 

SECONDARY STORAGE ... 

ANY ONE-OF THE FOLLOWING PHYSICAL DEVICES? 

1 'DRUM 

2 DS-250 

3 DS- 200 

4 RACE 

5 MAGNETIC TARE 

7 CARDS 

8 REMOTE CONSOLES 

9 TYPEWRITER 
,BRE 

10 CARD READER 

SECONDARY STORAGE IS COMPOSED OF TWO CLASSES OF WORDSs 
CLASS 1 WORDS ASSIGNED FOR USE BY A- FILE, AMD 
CLASS 2 WORDS WHICH ARE AVAILABLE FOR ASSIGNMENT ,. I.E. 
FREE STORAGE . ' . ■ 

FILE 

A FILE IS ANY SEQUENCE. OF N CM .MAY BE 0) WORDS. OF SECONDARY 
.STORAGE ASSIGNED BY THE EXECUTIVE FOR USE BY A" PROGRAM. • 

TYPES OF FILES 

C A *•"" A L G F "f i v 
A CATALOG FILE *IS A- FILE WHICH CONSISTS SOLELY OF 
ENTRIES WHICH CATALOG OTHER FILES. THAT IS EACH ENTRY 
NAMES A FILE OF THE SYSTEM. CATALOGS HAVE A RIGID FORMAT 
WHICH IS DETERMINED BY THE EXECUTIVE. ALSO THE USER CAN ONLY 
MODIFY CATALOG ENTRIES BY CALLING UPON EXECUTIVE ROUTINES WHICH 
CONVERT THE PARAMETERS OF THE CALL TO THE CORRECT FORMAT.. 

LOGICAL CONTENTS OF A CATALOG ENTRY. '•' 

NAME OF FILE . 

ACCESS LOCKS (READ , APPEND , WRITE , EXECUTE .RETIRE ? TRAP) 
PASSWORD OR NAME. OF TRAP FILE . -' 

STATISTICAL INFORMATION (DATE OF CREATION, OPENS SINCE CREATION) 
NUMBER OF DATA WORDS IN FILE 
: BEGINNING AND ENDING DEVICE ADDRESS,, PLUS FORMAT - 
TYPE. OF FILE (CATALOG OR DATA FILE) 

ATTACHMENT LEVELCCOUNT OF USERS' ATTACHED TO THE FILE) ' 
APPEND FLAG (ONLY ONE OF THE USERS ATTACHED TO THE FILE 
CAN BE APPENDING) 



•198 DATA FILE 

200 AMY FILE WHICH IS N0T A CATALOG. THE F0RMAT AMD C0MTEMT ■ 

202 8F DATA FILES ARE THE S0LE C0MCERN" 0F THE USER AMD ARE NAT 

204 RESTRICTED ■■ IN AMY WAY BY THE EXECUTIVE,. ■■ . 

206 • . 

208 ALL FILES C0MTAIN HEADERS AMD TRAILERS .-WHICH ■ ARE USED FBR 

210 LINKING PHYSICAL BLOCKS AND FOR REDUNDANCY CHECKING. • H0WEVER, 

212 HEADERSCAND TRAILERS') ARE INVISIBLE T0 THE PROGRAM USING THE' 

213 FILE. 

214 • ' • • 
2.16 ATTACHED VS. UNATTACHED FILES 

217 ■ ' ■..■■■"■■. 

2 IS " EACH FILE HAS AN ATTACHMENT LEVEL WHICH IS INCREMENTED BY 

220 0NE EACH TIME THE FILE IS 8PENED AND 'IS DECREMENTED EACH 

222 TIME THE FILE IS CLOSED. THUS THE ATTACHMENT LEVEL '■ ' 
224 COUNTS THE' NUMBER OF FILE PREFERENCE NUMBERS ASSIGNED T0 
.225 • THE FILE, 

226 • • - 

223 UNATTACHED FILE 

230 AN UNATTACHED FILE IS A CATALOGUED FILE WITH AN ATTACHMENT 

232 LEVEL OF 0. THUS AN UNATTACHED "FILE- IS NOT IN USE. 

233 

234 ATTACHED FILE 

236 AN "ATTACHED FILE IS AMY FILE WITH AN ATTACHMENT LEVEL 

238 WHICH IS GREATER' THAN 0. AN ' ATTACHED • FILE HAS THE 

240 FALLOWING PROPERTIES: ' l 

244 1 IT IS IN U^E BY ONE 0R MORE JOBS', . 

246 2 7ZR EACH JOB WHICH IS USING THE' FILE- THE EXECUTIVE SYSTEM 

248 HAS SUPPLIED A "FILE REFERENCE NUMBER" WHICH MUST BE USED 

230 WHEN REFERENCING THE FILE.OTHE FILE- REFERENCE NUMBER- IS 

252 -RETURNED AFTER A SUCCESSFUL OPEN.) 

254 3 FILE MAY BE UNCATAL0GUED . . . 6 AN UNCATALOGUED FILE IS 

256 ONLY TEMPORARY IN THE SENSE THAT IF IT' IS CLOSED 

257 BEFORE BEING CATALOGUED ITS CONTENTS ARE LOST. 

258 ONLY ATTACHED FILES MAY BE READ, APPENDED TO, 0R USED AS A CATALOG 
260 AN ATTACHED FILE MAY BE IN 0NE OF" THE FOLLOWING THREE 

262 SUBSTATESs ' 
264 1 NEUTRAL ' THAT STATE WHICH EXISTS AFTER A 'SUCCESSFUL 

266' . 0PEN BUT -PRIOR TO THE'FIRST READ OR APPEND REQUEST 

263 ' . . 
270 2 APPEMDABLE ' ENTERED ON EACH APPEND REQUEST. 

272 ' 

274 3 READABLE' ENTERED ON EACH READ,: 'SKIP .0R REWIND 

276 REQUEST. ■ 

278 ; ■ • 

279.PAG 

280 CATALOGUED VS IMCATAL0GUED FILES - ' . 

28i ' . 

282 CATALOGUED FILE 

284 ' ANY FILE WHICH IS REFERENCED BY AN .ENTRY IN A CATALOG, 

285 ■ ' 

286 UMCATALOGUED FILE 

288 ANY FILE WHICH- HAS BEEN GIVEN A FILE REFERENCE NUMBER 

300 (IT IS IN USE)- BUT HAS NOT YET BEEN CATALOGUED. 

302 - . - , ' 



LIST . 

MFC1 13s3i JUNE- 22,1966 

10 JUNE 22 (KML) 

100 HOLD FILE COMMANDS 

102 

104 EACH COMMAND IS IN THE FORM OF A SYSTEM MACRO* THE MACRO 

106 PROTOTYPE WILL BE SUPPLIED T0 EACH SYSTEM PROGRAMMER* EVENTUALLY 

108 THESE MACROS UILL BE A PART 0F MOLD'S SYSTEM LIBRAS Yb 

110 

112 WHEN A FILE COMMAND IS ISSUED T0 THE EXECUTIVE THE USER MUST • 

1 i'4 REAL^Z^ • "*"rA Vo 

116 V ~* " " "\ll ALL' REGISTERS (A ,Q 9 I AND INDEX REGISTERS) UILL 

US . HAVE BEEN DESTROYED,, 

120 (2) THE FUNCTION REQUESTED BY THE COMMAND UILL NOT HAVE 

122 BEEN' CARRIED OUT, ' 

124 . C3) INDEX REGISTER 0: UILL BE EER0 IF THE COMMAND UAS . 

126 ACCEPTED AMD NOM' ZERO IF THE COMMAND IS 

128 SYNTACTICALLY -INC0RRECT, AND- . 

130 (4) THAT EACH COMMAND MUST. SPECIFY A TRAP PROGRAM ' 

132 WHICH UILL BE INVOKED WHEN- THE REQUEST 

134 HAS BEEN CARRIED T0 COMPLETION 0R ABSRTED DUE T0 

136 AN ERR0R 0F SOME SORTo 

138 THE PROGRAM CAN THEN CONTINUE EXECUTION IN PARALLEL WITH THE 

140 EXECUTION 0F THE FILE 0PERATI0No WHEN- THE EXECUTIVE HAS 

142 COMPLETED THE TASK C0R TASKS) REQUESTED BY THE. COMMAND THE 

144 PROGRAM UILL BE INTERUPTED AND C0NTR0L UILL BE TRANSFERRED 

146 TS THE TRAP PROGRAM* THERE MUST BE A SEPARATE TRAP' PROGRAM 

1.48 FOR EACH FILE C0HMAMD OUTSTANDING,, IF THE PROGRAMMER IS 

150 CLEVER' HE UILL SEE THAT HE C0ULD USE THE SANE TRAP ROUTINE 

152 IF HE PROVIDES THE EXECUTIVE UITH 4 U0RDS UHICH PURPORT TO 3E 

154 THE FIRST FOUR U0RDS 0F A TRAP PROGRAM THE EXECUTIVE .ASSUMES 

156 THAT THE FIRST F0UR U0RDS 0F THE TRAP PROGRAM CAN BE USED F0R 

158 0R -ALWAYS CONTAIN THE F0LL0WING8 

' STATUS RETURN WORD I 

SRU1 (18,35) CONTAINS THE TYPE 0F RETURN 
■ STATUS RETURN U0RD 2 

THE EXECUTIVE ST0RES THE INTERUPT- L0CATI0N 
. PLUS 1 AND THE INDICATORS IN THIS L0CATI0No 

THE EXECUTIVE DOES THE EQUIVALENT 0F A 

"STC1 U0RD3"o" THE TRAP PROGRAM MUST 
• EXIT BY EXECUTING "RET U0RD3 "V 

FIRST LOCATION 0F THE TRAP PROGRAM' 
THE ORDER IN UHICH THE PROGRAM EXECUTES FILE 
COMMANDS UILL PROBABLY NOT BEAR ANY RELATION T0 THE 
ITS • 0RDER IN UHICH- THE ASSOCIATED TRAP PROGRAMS ARE 
ISO • ' ENABLED. DON'T TRY T0 DISCERN ORDER WHERE NONE 

182 EXISTSo ' 
184 ' ' 

i ^6 • 

183 OPENING A FILE 

190 IN ORDER T0 USE ANY FILE IT MUST FIRST BE ASSIGNED A 

192 FILE REFERENCE NUMBER*' ALL SUBSEQUENT COMMANDS UHICH AFFECT 

194 THIS FILE MUST SUPPLY THE FILE REFERENCE NUMBER AS A PART GF 

196 THE COMMAND. THUS THE FILE REFERENCE NUMBER IS THE NAME UHICH 

198 THE EXECUTIVE AND THE PROGRAM USE TO DESCRIBE THE FILE WHILE • 

200 IT IS ATTACHED T0 THE PROGRAM 
202 . 



160 


WORD 


1 


162 






164 


^GRD 


2 


166 


■WARD 


3 


168 






169 






170 






171 






172 


U0RD 


4 


174 


WARNINGS 




176 




i 



206 

208 OPEN .T 9 FR P NAME 9 PASSWORD, (ACCESS LIST) 

210 T LOCATION OF TRAP PROGRAM . 

212 FH FILE REFERENCE NUMBER OF CATALOG FILE T0 SEARCH • 

214 NAME ' NAME 0F THE FILE . . • 

216 PASSWORD MUST 3E EQUAL T0 PASSWORD IM CATALOG ENTRY 

218 . (ACCESS LIST) LIST 0F THE OPERATIONS WHICH THE PROGRAM 

220 WILL BE 'CARRYING OUT ON THE FILE* MUST BE 

222 ONE 0F THE FOLLOWING s APPEND,READ ? CO?Y 3 

224 EXECUTE OR LINK* 

226 

228 EXAMPLE OPEN TRAPL,FRCAT, BASBAL, PL, (READ,EX£CUTE) 

230 

232 THIS COMMAND REQUESTS THAT A CATALOGUED FILE BE ASSIGNED 

234 A FILE REFERENCE NUMBER. 

236 .- . ■ ■ ■ ■ • ...-. 

235 TYPE OF -RETURN ■ MEANING 

24.0 % " • NORMAL RETURN ' . 

242 '■■ SRW1(0 P 17) CONTAINS THE FILE REFERENCE 

244 ! NUMBER ASSIGNED BY THE EXECUTIVE 

246 v . ' SRU2(0,U)' FILE' ACCESS FLIP FLOPS 

248 - G INDICATES READ PERMISSION 

250 i INDICATES APPEND ■ PER HI SSI ON 

252 2 INDICATES. WRITE PERMISSION 

254 ■ , .3" -'■ -0 INDICATES EXECUTE PERMISSION 

256 -4-1.1 ' THESE BITS ARE. NOT YET USED 

258 SRW2(i2 5 35) CONTAINS THE COUNT OF THE 

260 NUMBER OF WORDS. IN THE FILE ' 

262 1 - NOT APPLICABLE 

264 : 2 " NOT APPLICABLE 

266 3. . UNRECOVERABLE ERROR 

270 • 4 FILE REFERENCE NUMBER CFP^ HAS NOT BEEN 

272 ASSIGNED 

274 5 PROTECTION VIOLATION loSo THE TYPE OF ACCESS 

276 REQUESTED IS NOT ALLOWED OR THE PASSWORD 

273 WAS NOT EQUAL TO THAT IN THE CATALOG 

'200 6 CATALOGUE FR HAS NO ENTRY WITH SAME FILE NANS 

2C2 EQUIVALENT TO "PROGRAM NOT SAVED" 

285- 7 BUSY 

2S6 OPENING AN UNCATAL0GUED .FILEC TEMPORARY) 

pcjp* ...■■'■ 

290 OPEN T 

291 

292 EXAMPLE. OPEN TRAPL ' ■'" 

294 • 

296 .THIS COMMAND REQUESTS THE ASSIGNMENT OF A FILE REFERENCE 

295 'NUMBER FOR A FILE WHICH INITIALLY CONTAINS O-U0RDS 
300 AND WHICH NAY BE ACCESSED IN ANY ALLOWED MANNER *• 
509 

304 TYPE OF RETURN MEANING 

306 NORMAL RETURN SRM AND SRW2 HAVE 

308 ' THE SANE MEANING AS OPEN FOR A- 

310 CATALOGUED FILE 

312 .3 UNRECOVERABLE ERROR 

314 6 '. ' NO SPACE AVAILABLE FOR TEMPORARY STORAGE 

316 • . THIS SHOULD NOT OCCUR ' 

317 7 • BUSY 

7i 1 R ■ 



LIST 



MFC2 • 13232 . JUNE 22 P 1966 

100 MOLD FILE COMMAMDSCCONTINUED) 
110 . , 

120 COMMANDS WHICH APPLY ONLY TO ATTACHED FILES 
130 

140 !0NLY ATTACHED FILES CAN USE THE READ, APPEND, ' 

150 -REWIND, SKIP OR CLOSE COMMANDS^ ONLY ATTACHED 

160 UNCATAL0GUED FILES CAN BE REFERENCED WHEN USING 

170 THE CATALOGUE COMMAND* THE DESTROY COMMAND 

180 (WHICH DESTROYS A CATALOGUE ENTRY) CANNOT BE 

182 USED WITH ATTACHED FILES 

190 

200 . READ T 9 FR 9 -NjM ' . 

22 T TRAP LOCATION 

220 FR FILE REFERENCE NUMBER 

230 ' N NUMBER OF WORDS TO BE READ 

240 M . MEMORY LOCATION INTO WHICH FIRST WORD GOES 

250 • 

260 THIS COMMAND' REQUESTS THE NEXT N WORDS FROM 

270 ' -FILE'FR BE PLACED IN LOCATIONS M 9 K>2 9 coo MXN~l)o 

•27! ■.■"■■■. 

272 "TYPE OF RETURN MEANING 

273 NORMAL RETURN 

274 1- END OF RECORD ■ (SRW2 CONTAINS THE RESIDUE) 

275 2 • ■- END OF FILE CSRW2 CONTAINS THE RESIDUE) 

276 • 3 • UNRECOVERABLE ERROR 

277 '■-. A • • FR HAS NOT BEEN ASSIGNED 

278 5 ' PROTECTION VIOLATION 

279 7 FILE BUSY 

280 ' ' 

300 REWIND T 9 FR - . . 

310 T .TRAP LOCATION 

320 FR . FILE REFERENCE NUMBER 

330 

340 • ■ THIS COMMAND RESETS THE READ POINTER SO THAT A 

350 • ■ SUBSEQUENT READ COMMAND WILL GET THE- FIRST N 

360 WORDS. OF THE FILE* 



yji i lire vx* ftiiiUrtN FJ&flNJLNb 

372 N0RMAL RETURN 

373 ' . A FR HAS NOT BEEN ASSIGNED 

374 • 5 l PROTECTION VIOLATION 

375 7 FILE BUSY 
375 

400 SKIP T 5 FR 9 N 

410 T 1HAP LOCATION 

420 JR FILE REFERENCE NUMBER 

430 . N NUMBER 0F WORDS T0 SKIP 0VER 

440 •■■..- 

450 1>IIS COMMAND ADDS N T0 THE READ P0INTER„ IT IS 

460 EQUIVALENT T0 READING N 170RDS INTO A SCRATCH' AREAo 

470 ■ . ■ ■ . 

471 TYPE OF RETURN. ME AN IMG 

472" ■ 1 END 0F REC0RD (SR172- CONTAINS THE RESIDUE) 

473 • THE NEXT WORD READ v/ILL BE THE 0NE 

474 • FOLLOWING THE END OF RECORD 170RD 

475 2 . . END OF FILE (SRW2 CONTAINS THE RESIDUE) 

476 . ■ "■■, 3 . UNRECOVERABLE ERROR 

477 •' A . . VR NOT ASSIGNED 

478 5 . PROTECTION VIOLATION' 

479 7 -. . , FILE BUSY 

480 ■■■ 

500 APPEND Tj,FR 9 "N 9 M- 

510 T TRAP LOCATION 

520 ' FR FILE REFERENCE NUMBER . . 

530 N NUMBER OF WORDS TO APPEND T0. THE FILE ' 

540 M MEMORY LOCATION 0F THE N WORDS 

550 

560 THIS. COMMAND REQUESTS THAT THE N WORDS IN MEMORY 

570- LOCATIONS M 9 KH i06 o KKN-1) BE ADDED TO THE 

580 END OF FILE VR 

581 

582 TYPE OF RETURN MEANING 

533 NORMAL RETURN 

584 i END OF RECORD (SRW2 CONTAINS THE RESIDUE) 

5S5 2 END 0F FILE (SRW2 CONTAINS THE RESIDUE) 

586 3 UNRECOVERABLE ERROR. 

537 . . ■ 'A ■ ' FR NOT ASSIGNED 

533 5- " PROTECTION VIOLATION 

589 7 FILE BUSY 

590 ' 



APPENDING, ETC. ; IN.0. 



ST0P. 
READY. 

LIST. 



MFC3 11:41 JUNE 24, 1966 . 

.LAST 'MODIFIED 1137, 24/6/66 (XML) 
1 

2 '" • 

100 MOLD FILE COMMANDSCCONTINUED ) ' 
104 " '■: •' : 

108 COMMANDS' WHICH APPLY 0NLY TO. ATTACKED UNCATAL0GUED FILES 
112 

116 TEMPORARY (ATTACHED UNC ATALOGUED ) FILES CAS BE' USE]} A'S 
120 A SCRATCH PAD . ..THAT IS THE CONTENT OF THE .FILE CAN BE 
124 -SCRATCHEDCFILE -IS THEN EMPTY) WITH3UT LOSING THE FILE REFERENCE 
128 NUMBER. ALSO TEMPORARY FILES CAN BE CATALOGUED OR USED 
132 TO REPLACE THE FILE CONTENTS OF A CATALOGED FILE. 
136 ' -.-..■ 

140 SCRATC T,FR ■' ; • 

lA'A ' T ' TRAP LOCATION • 

148 • FR .' FILE REFERENCE NUMBER ' 
152 '. 

156 COMMAND RESETS THE FILE • WORD COUNT TO -ZEROo THE 
160 FILE REFERENCE MUMPER MAY STILL. BE USED FOR READING, 
164 . APPENDING, ETC , ; I N • OTHER .WORDS,' SCRATCH PUTS, THE FILE 
168 'BACK IN THE CONDITION IMMEDIATELY FOLLOWING AN OPEN. . 
172 ■ THE COMMAND IS FULLY EQUIVALENT T0 A CL0SE FOLLOWED 
176 BY AN 0PEN WITH A GUARANTEE THAT THE FILE REFERENCE 
ISO • NUMBER RETURNED AFTER THE 0PEN"IS THE SAME AS -THAT USED 
.184 " IN THE CLOSE. 
\ v c \ 

192 TYPE "OF RETURN MEANING 

196 ... ' NORMAL RETURN 

200 . . 3 .. ■ .UNRECOVERABLE ERROR 

204 4- *FR NOT ASSIGNED 

208 5 PROTECTION VIOLATION- 

212 . 7 'FILE BUSY 



220 
224 
228 
232 
236 
240 
24 4 

243 

252 

256 

260 

264 

26?? 

272 

276 

280. 

284 

288 

292 

296 

300 

304 

308 

3 12 

316 

320 

324 

328 

332 

336 

340 

344 

348 

352 

35"6 

360 

364 

368 

3 72 

376 

380 



T 

FBI 

FR2 

NAME 

PASSWORD 

(A P) 



l j riil jri^, 5 '.•i,'-\i'ir- , J t\:>zjV />riu 9 v.huucoo r iw-mj.; 

TRAP L0CATIR-N 

CATALOG FILE REFERENCE NUMBER 

UNCATALOGIJED FILE . ' ■ 

FILE NAME 

PASSWORD TO RE PUT IN ENTRY 

TYPES OF ACCESS WHICH WILL BE 



PROHIBITED 



CATLOG CAUSES- THE FILE WITH FILE REFERENCE NUMBER FR2 . 

TO BE ENTERED INTO THE CATALOG FILE WITH FILE REFERENC 
THE. ENTRY WILL BE. CREATED USING THE NAME 
ACCESS PROHIBITIONS LISTED . IN ■ THE 



NUMBER FR1. 
PASSWORD AND 



THE PROGRAM RETAINS THE FILE 
F0R ALL TYPES OF 



MACRO. • 
AS AN ATTACHED CATALOGUED 
ACCESS. 



TYPE 0F RETURN 
.0 

3 

/. 

5 
6 
7 



MEANING . •■ 
NORMAL RETURN 
UNRECOVERABLE ERR0R - 
FR1 OR FR2"N0T ASSIGNED 
PROTECTION' VIOLATION . 
ENTRY WITH SAME- NAME IN 
FILE BUSY 



FR1 



PENCE 



NUMBER 



■REPLAC T,FR1,FR2, NAME, PASSWORD, (ACCESS PR0HIEITI0NS) 

T 
. . ■ FR 1 

FR2 

NAME 

PASSWORD 
.(A P) TYPES 0F ACCESS WHICH WILL BE- PROHIBITED 



TRAP LOCATION 
CATALOG FILE REFE 
UNCATAL0GUED FILE 
FILE NAME 

PASSWORD TO BE PUT IN 
TYPES 0F ACCESS WHICH 



ENTRY 
WILL BE 



•' -REPLAC "CAUSES FILE FR2 T0 REPLACE THE FILE POINTED T0 
BY THE ENTRYG/ITH THE SAME NAME) IN CATALOG FILE FR 1 ♦ 
THE COMMAND IS EQUIVALENT TO A DESTROY FOLLOWED BY A ■ 
CATLOG. " . 

TYPE OF RETURN MEANING 

NORMAL RETURN 

3- •.•■■■ UNRECOVERABLE ERROR 

4 FR1 OR FR2 NOT ASSIGNED 

5 PROTECTION VIOLATION . 
7 • FILE BUSY 



LIST 



MFC 4 13:44 JUNE 22,1966 

100 MOLD FILE COMMANDS (C ONTI NUED) 
104 ■ - . 

108 CLOSING AN ATTACHED FILE 
112 : 

116 AMY PROGRAM WHICH OPENS A. FILE SHOULD CLOSE THAT 'FILE 
120 PRIOR TO TERMINATING. IF THE PROGRAM DOES. NOT CLOSE 
12-4 THE FILE THE SUBSEQUENT ACTION OF THE EXECUTIVE IS 
128 UNDEFINED AND WILL PROBABLY BE UNPREDICTABLE. 
132 • 

136. . THOSE FILES WHICH HAVE BEEN PASSED ALONG' VIA A SPAWN 
140 REQUEST WILL NOT BE. CLOSED BUT WILL BE PASSED BACK TO. 
144 THE JOB WHICH REQUESTED THE SPAWN. IF THE JOB WHICH ' 
148 PASSED ALONG THE FILE THROUGH THE SPAWN COMMAND DID 
152 NOT REQUEST THAT THE FILE BE PASSED BACK .THE" FILE WILL BE 
156 CLOSED IN A NORMAL FASHION.. THUS THE PROGRAM SETTING UP 
160 THE SPAWN IS PARTIALLY PROTECTED FROM THE VAGARIES OF THE . 
164 PROGRAM. AT THE LOWER LEVEL OR LEVELS. ' 
68 • ■..■'-■■ 
172 

176 • CLOSE T,FR 

180 ■ T TRAP LOCATION 

184 FR FILE REFERENCE NUMBER 
188 

192 IF FR REFERS TO AN UNCA.TALOGUED FILE THEN THE • 
196 ' SPACE ALLOTED IS 'RETURNED TO FREE STORAGE. IF 

200 FR- REFERS TO A CATALOGUED' FILE THAN THE CATALOG 

204 ENTRY CORRESPONDING TO THIS FILE WILL BE UPDATED 

208 (ATTACHMENT LEVEL DECREASED AND IF THE PROGRAM APPENDED 

212 TO THE FILE THE APPEND FF IS RESET) AMD IF THE . 

216 FILE HAS ACTUALLY BEEN MODIFIED IT IS WRITTEN ON .THE 

220 ■ INCREMENTAL DUMP TAPE. IN EITHER CASE THE FILE . •■ 

22.4 REFERENCE NUMBER IS NO LONGER ASSIGNED -AND MAY BE 

228 ~ . REASSIGNED BY THE EXECUTIVE. 

232 

236 TYPE 

240 . 

24* 

248 

252 

253 

256 

260 
N 264 



OF RETURN 


■MEANING 


o ■ 


NORMAL 


3 • • 


UNRECOVERABLE. ERROR 


4 


' FR NOT ASSIGNED 


5 


• PROTECTION VIOLATION 


7 


FILE BUSY 



27?. CATALOG MAINTENANCE ' 

276 

280 READ T,FR,N,M 

2*4 T TRAP LOCATION 

288 FR FILE REFERENCE NUMBER OF CATALOG FILE. 

292. N NUMBER 0F CATALOG ENTRIES T0 BE READ 

?96 M MEMORY LOCATION 

/on 

304 PROVIDES AN EDITED LOOK AT THE CONTENTS OF THE . 

30?. NEXT' N ENTRIES OF THE CATALOG WITH FILE REFERENCE' 

31? NUMBER FR. THE INITIAL IMPLEMENTATION WILL RETURN 

316 TWO WORDS PER ENTRY. THE ASCII CHARACTERS 

320 USED AS A NAME FOR THE FILE WILL BE LEFT JUSTIFIED- 'IN 

324 THE 2 WORDS. ADDITIONAL INFORMATION WILL 3E PROVIDED 

328 ' AD HOC. * ••'•... 

332 ■■".. 

336- ■■ TYPE OF RETURN MEANING 

340 NORMAL RETURN 

344' 1 END r A? RECORD (SRW2 C0MTAI NS THE -RESIDUE) 

34* 2 END OF FILE (SRW2 CONTAINS THE. RESIDUE). 

352 3. UNRECOVERABLE ERROR 

356 '4 FR HAS MOT BEEN ASSIGNED. 

360 5 PROTECTION VIOLATION ■'. 

361 " 7 FILE BUSY 
364- • 

36* REWIND T 9 FR 

372' T "TRAP LOCATION 

376 FR FILE REFERENCE NUMBER 

380 " 

384 . " THIS COMMAND RESETS THE READ POINTER SO' THAT A 

388 SUBSEQUENT READ COMMAND WILL. GET THE FIRST ,N " •- 

J592 .'CATALOG ENTRIES , OF' THE FILE. '. 

396 

400 TYPE OF RETURN MEANING . 

404 '"0 NORMAL RETURN 

408 .4.- FR HAS NOT BEEN ASSIGNED . 

412 5 PROTECTION VIOLATION 

416 

420 SKIP T,FR,N 

424 ' T - TRAP LOCATION 

42« FR FILE REFERENCE NUMBER 

432 N' , NUMBER OF ENTRIES TO SKIP OVER 

436 • : , 

440 THIS COMMAND ADDS N TO THE. READ POI NTER." IT IS 

444 • EQUIVALENT TO READING M ENTRIES' INTO A SCRATCH AREA. 

448 

452 TYPE OF. RETURN' MEANING 

456 1 END OF RECORD (SRW2 CONTAINS THE RESIDUE.) 

460 2 . END OF FILE (SRW2 CONTAINS THE RESIDUE)- 

464 3 UNRECOVERABLE ERROR ' 

468 4 FR NOT ASSIGNED 

472' 5 PROTECTION VIOLATION 

476 ' 6 ' . NAME N.OT IN CATALOG 

477 7 • FILE BUSY • ' 
480 



48P 


49? 


4Q6 


500 


504 


508 


512 


516 


520 


• 524. 


52? 


532 


. 536 


540 


• 544 


5 48 


5/io 


552 


556' 


/560 


* J 56? 


"N 572 


576 
S'80- 



DESTR0 T,FR, NAME, PASSWORD 

T • TRAP LOCATION 

FR . FILE REFERENCE NUMBER OF CATALOG 

NAME NAME OF ENTRY TO 3E DESTROYED 

THIS COMMAND WILL DESTROY THE ENTRY WITH THE NAME 
SPECIFIED IN THE CATALOG FILE FR IF THE USER 
HAS OPENED CATALOG FR FOR WRITING AND THE PASSWORD 
SUPPLIED MATCHES THAT IN THE ENTRY. 

TYPE OF RETURN MEANING 

1 . NORMAL RETURN 

3 UNRECOVERABLE ERROR • 

' ' A ■ FR' NOT ASSIGNED 

5 PROTECTION VIOLATION. 

6 MO ENTRY WITH. NAME SPECIFIED 

7 FILE BUSY - 



HANDLING SPASTIC TYPE TILES ...-. THAT IS FILES WHICH ■ 
PRODUCE DATA AT THEIR DISCRETION AT NOT NECESSARILY AT 
"SPASTICS". 



UDFC, "USER DEFINED FILE COMMANDS" 



0LD 

0LD PROBLEM NAME— HEDITS 

■READYo ' ' ' 

LIST 

MEDITS loso9 JUNE 22,1966 

■1.00 LAST CHANGE HEREs 2259, 20/6/66 CTRJ3 

.110 

120 

150 

1 40 

150 JUNE 16 9 -1966 KML 
1 60 
170 
180 

190 ' - SUMMARY 0F COMMANDS F0R K0LDY. EDIT0R 

200 
23 

220 - 0LD . F|F| ocooc |F 

230 '" ■ ■' 

240 'NEW N$N$ .••••• |N 

"250 

260 RENAME Nj N| N; N? o*ooo jNjN 

270 

280 SCRATCH Nj'N; • .. ?-N 

290 

300 LIST N|B 9 B 9 QO , 9 B . 

310 

320 'S0RT N 

330 

340 DELETE NfBpB, oo ,B 

350 

360 EXTRACT N§B 9 B P 00 'o 9 B 

370 

380 RESEQUENCE NjL,L,I- 
390 

400 SAVE F?Fr coo oc ?F 

410 

420 UNSAVE Ff F? 4 ,,oo?F 

430 ■ ■ ' " . ■ ■ 

440 APPEND N5N5 6c o §N 

450 

460 . BUILD N 

470 

430 RELEASE ' Nj N| ' 0*0 ;N 

490 • 
500 EXIT 

c;t n . . . 



?>:u 




530 




540 




550 


N:. 


560 




570 


P: 


5S0 




590 


B$ 


600 




610 


U 


620 




630 


Is 


640 




650 


Fs 


660 




670 




6S0 





N0TATI0N 
NAME 0F.A FILE 
■PASSW0RDC0PTI0NAL) 

BLOCK 0F Ll"NESCTv}0 LINE NUMBERS SEPARATED BY "-") 
LIKE NUMBER 
INTEGER 
FILE IDENTIFIER^?' F0Rtfs <FILENAME P P>) 



*LD 

jLD -PROBLEM. NAME— MEDIT1 

READY c - 
LIST 

MEDIT1 ' 13:41. JUNE 22,1966 

100 'LAST CHANGE HERE: 2305, 20/6/66 CTRJ3 

105 . 
110 
115 

120 JUNE 15,1966 CKML)' 
'125 

130 . 
135 

140 * * * A LITTLE ST0RY A30UT THE MOLDY EDITOR- * * #. . 
145' 
1 50 
155 

160 THE MAINTENANCE' 0F' ALL SOURCE FILES IN &JLD WILL NORMALLY 

165 BE DONE BY USING THE SYSTEM CALLED " EDITOR"; EDIT0R 

170 CAN BE CALLED BY TYPING- "RUN EDITOR" IF- YOU ARE NJT IN A 

A75 CONVERSATION WITH SOME OTHER SYSTEM PROGRAM. .IF. YOU ARE 

180 IN A CONVERSATION- WITH AN0THER SYSTEM PROGRAM YOU. MUST • 

'185 FIRST EXIT FROM THAT PROGRAM BY TYPING "EXIT". 

190 ' 

195 AFTER EDITOR IS 10 AD ED -IT WILL TYPE EDITOR AND WAIT FOR 
200' A- COMMAND 10 BE ISSUED. AFTER A LEGITIMATE COMMAND HAS BEEN 

205 ISSUED EDIT0R CARRIES OUT THE FUNCTION REQUESTED BY THE COMMAND. 

210 'WHEN FINISHED WITH' THE TASK EDITOR TYPES OUT "READY" AND 

215 WAITS FOR ANOTHER COMMAND . IF THE" CsdrfKAND HAPPENS TO BE 

220 UNRECOGNIZABLE 0R INVALID F0R SOME REAS0N "INVALID EDITOR. 

225 COMMAND" WILL BE TYPED. AFTER EITHER RESP0NSE T0 A C0MMAND- 

230 EDIT0R IS READY T0 ACCEPT .AN0THER C0MMAND. DURING" THE 

235 EXECUTION 0F THE COMMAND 0THER COMMANDS WILL N0T BE 

240 RECOGNIZED. v - . 
24 5 

250 IN CONTRAST 10 THE DARTMOUTH TIME SHARING SYSTEM MOLD 

255 ALLOWS. A- USER "©BE W0RKING WITH 'MORE THAN 0NE FILE AT A . 

260 TIME. ■ THIS MEANS THAT EDITOR COMMANDS SUCH AS LIST, DEL, ETC .■ 

265 MUST. M0W GIVE THE NAME 0F THE FILE WHICH IS. T0 BE USED' WHEN 
270. EDITOR CARRIES OUT THE C0MMAND. ALS0 SOME C0MMANDS SPECIFY A 

275 PASSW0RD WHICH CAN BE USED AT THE USERS OPTION. 

280 • 

285 THERE IS 'A RESTRICTION 0N FILENAMES AND' PASSWORDS , NAMELY THAT 

290 THEY MUST NOT CONTAIN: 
29 5 

300 T) LEADING BLANKS 

)305 . 2) COLONS [: 3 ' 

310 3) SEMI -COLONS [; 3 

315 4) COMMAS [-,] 

320 ' 

325 IN THE COMMAND DESCRIPTIONS BELOW , A "FILE IDENTIFIER" IS 0F THE 

330 FOLLOWING FORM: <FILENAME>, <0PTI0NAL PASSW0RD> • 



340 

345 OLD FILE IDENTIFIER ; FILE IDENTIFIER; .... • ; FILE IDENTIFIER . 

350 

355 GETS CATALOGUED (SAVED) FILES FOR USE DURING THE RUNNING 

360 OF EDIT0R. IF A PASSWORD IS INVALID OR THE ." USER 'S FILE 

365 DIRECTORY 03 ES NOT C0NTAIN AN ENTRY. WITH ■■A ■ FILE NAME 

370 GIVEN IN THE COMMAND, EDITOR WILL TYPE "INVALID EDIT COMMAND" . 

375 ALL SUBSEQUENT COMMANDS TO' EDIT0R RELATING. TO HE . FILE • MUST 'USE 

380 IKE FILENAME (WHICH MAY BE CHANGED 3Y RENAME).' 

385 . 

390 NEW FILENAME ; FILENAME; ; FILENAME • . 

39 5 

400 OPENS TEMPORARY FILES WHICH WILL. BE GIVEN THE NAMES WHICH 

405 APPEAR IN THE COMMAND. ALL SUBSEQUENT COMMANDS RELATI NG 

410 10 ONE. OF THESE FILES MUST USE THE 'NAME. OF THE FILE. 

415 TEMPORARY FILES MUST BE SAVED DURING ■ AN ' EDITOR RUN- OR THEY 

420 WILL BE 10ST ON EXIT FROM EDIT0R . . 

425 ■ • •■■ ' 

•430 RENAME' NAME1A ; J&ME1B ; N&ME2A ; NAME 23 ; .....'; NAi'lENA ; NAMENB .• • 

•435" ■ : ■'.'■■ 

440 RENAMES FILE NAME1A 10 NAME13, FILE NAME2A 10 MA ME 23 , ETC., 

445 THE NAMES MAME1A , NAME2A , . ETC . , MUST HAVE BEEN USED ■ 

450 PREVI0USLY IN AN OLD, NEW, 0R RENAME COMMAND. 
455 

460 SCRATCH NAME1 ; NA?4E2; ;.NAMEN 

465 , 

470 THE CONTENTS 0F THE FILES NAMED ARE L4ST BUT THE NAMES ARE 

475 STILL AVAILABLE F0R USE. IN ■ EFFECT THIS ERASES THE' CONTENTS 

480' OF A FILE BEING USED AS A SCRATCH PAD. 

485 

490 RELEASE NAME1-; N4ME2; ..... ; i^MEN 

495 ' 

500 THE FILES NAMED ARE RELEASED. THAT IS T0 SAY, THE . CONTENTS 

505 ARE ifiST AND IKE NAMES, ARE N0 LONGER ' AVAIL3LE FSR USE . 

5-10 IN EDIT0R COMMANDS. IF YOU HAVE A SAVED FILE 0F THE SAME NAME 

515 IT IS UNALTERED. 

520 * ■ ■ . • . '. • . 

525 UNSAVE 'FILE IDENTIFIER; FILE IDENTIFIER-; ..... ; FILE IDENTIFIER 

530 . . 

535 IF THE- PASSWORD(S) MATCH THOSE- IN THE CATALOG ENTRY (S) 

540 WITH. THE NAME(S) GIVEN, THE ENTRY(S) WILL 3E EXPUNGED FROM 

545 THE FILE DIRECTORY (CATALOG) . -. 

550 

555 SAVE FILE IDENTIFIER; FILE IDENTIFIER; ; FILE IDENTIFIER 

560 

565 FOR EACH FILE IDENTIFIER GIVEN: 

570 IF NO ENTRY OF THE SAME NAME APPEARS IN THE FILE 

575 DIRECTORY, AN ENTRY WITH THE NAME AND PASSWORD 

580 GIVEN IN THE COMMAND WILL BE CREATED.' THE CONTENT 

585' OF THE FILE- WILL BE 'THE CONTENT OF THE FILE WITH THE 

590 SAME NAME. BEING USED IN THE EDITOR -RUN.' IF. THE CATALOG 

595 CONTAINS A ENTRY OF THE SAME NAME, EDITOR. WILL TYPE 

600 "FILE OF SAME 'NAME SHALL" I REPLACE IT?"... ANSWER YES OR NO. 

605 

610 - 

615 

620 

62 5' CONTINUED IN MEDIT2 



LIST 

KEDIT2 • . 13s42 JUNE 22,1966 

100 LAST CHANGE HEREs 2142,, 20/6/66 CTRJ 3 
110 
120 
•130 
140 

150 CATALOG 
160 

170 LISTS THE NAMES OF' ALL ENTRIES" IN THE CURRENT FILE DIRECTORY. . 
ISO THIS COMMAND HAS- EXACTLY THE SAME EFFECT AS THE COMMAND 
190 OF THE SAME NAME IN THE .DARTMOUTH TIME SHARING SYSTEM*. 
200 

210 APPEND NANE5NAME1-J-NAME25 *oco. $NAMEN 
220 '■'.■■ 

230 THE CONTENTS OF FILES WITH NAMES NAME1 THROUGH NAMEN ARE 
240 APPENDED T0 THE FILE NAME. THE FILES NAME! , NAHE2, ■■•... 
250 ARE NOT ALTERED BY THIS COMMAND* 
260 
270 BUILD NAME 

con " 

290 THIS COMMAND IS USED T0 ADD TELETYPED INPUT T0 A FILE. 

300 AFTER RECEIPT OF THE COMMAND EDITOR WILL TYPE GO. AHEAD.' 

310 THE EDITOR WILL APPEND ALL SUBSEQUENT CHARACTERS TYPED IN 

320 AT THE REMOTE. CONSOLE UNTIL FILE BUILDING MODE IS EXITED. 

330 THE EXACT METHOD OF- EXITING FILE BUILDING MODE HAS 

340 NOT YET BEEN' SPECIFIED BUT WILL PROBABLY BE EITHER A VACUOUS 

350 LINE OR A LINE WHICH DOES NOT BEGIN WITH A DIGIT. 

360 

370 LIST NAME§<BL0CK OF LINES>j«BL0CK OF- LINES> 5 coo 9 <B'L0CK. 0F LINES> 

3^0 

390 LIST THE CONTENTS OF THE FILE "NAME". THE FILE 

400 ITEMS ARE OMITTED THEN THE ENTIRE FILE WILL BE TYPED 

410 OUT ON THE REMOTE PRINTER. • IF. THE OPTIONAL ITEMS ARE 

420 INCLUDED THEN ONLY THE BLOCKS SPECIFIED UILL BE 

430 TYPED OUT. A BLOCK OF LINES CAN BE. SPECIFIED BY GIVING 

440 A SINGLE LINE NUMBER OR TWO LINE NUMBERS' SEPARATED 

450 BY A DASH. 

460 - ' 

470 SORT NAME 

4S0 . 

490 

500 

510 

520 

530 

540 

550 RESEQUENCE NAME5NI ,N2,N3 

560 




570 
5 CO 
520 
600 
6.10 
620 
630 
640 
650 
660 
670 
6G0 
690 
700 
995 
996 
997 
99S 
999 



CAUSES THE LI WE NUMBERED FILE WITH THE NAME GIVEN TO BE 
RESEQUENCSD STARTING AT LINE NUMBER N2 WITH THE INTEGER 
N3 USED AS THE INCREMENT 



DELETE NAME5<BL0CK 0F LINES*, <3L0CK Q? LINE3> 



2 O O O Q 



-3L0CK 0F LINES> 



DELETES THE BLOCKS OF LINES IN THE FILE "WAKE"* A BLOCK 
OF LINES IS EITHER A SINGLE LINE NUfcBER OR VdQ LINE 
NUMBERS SEPARATED SY A "-"• • 

EXIT 

THIS CSMNAND IS USED T0EKIT ??&& THE EDITOR* 



-*- »v ,•-. 
*V* "%^ *** 



END N0LDY EDIT 



MDDTS 13S43 JUNE 22,1956 

1 LAST CHANGE HEREs V 0309 9 -.20/6/66 

3 

6 • 

7 

8 

9 .' ■ ■ 

10 * * * * * '-SUMMARY OF COMMANDS FOR MOLDY DDT * .# *■ * * 

• 12 

• !4 

15 LOAD N„Ps N 9 P|. 000 o*| N,P 

IS . 

20 ■■ -FORMAT M 

25 

30 DUMP A| As •ooooS- A # 

OP 

40 PATCH A!? "Us \)% • •••■•$ U 

45 

60 BREAK A i, I j, As Al p 2j>Af ••*o.-S A1*I A 

61 ■ 

62 UNBREAK Al| Alt 00000?' Al # 
65 

70 CONTINUE I # 

75 

SO -TRANSFER Al £ 

85 

90 * REGISTERS R| .■ Rs . o.-o.o-s R # 

95 

100 ALTER Rj>Uf R$> Ws 00000? Rj>W # 

1 102 • - 

103 SAVE N ' £ . 

104 
105 

no . 

115 ' 

200 NOTATIONS 

220 

220 : As SINGLE ADDRESS, 0R'PAIR OF" ADDRESSES- SEPARATED BY COMMAS 
225- 

230 ■ Alt' SINGLE ADDRESS 
235 

240 ' Is ITERATION -COUNT 
245 

250 . Rs REGISTER IDENTIFIER 
255 

260 , Ms • OUTPUT MODE 
262 

263 Ns -NAME 
264 

265 ?% PASSWORD 

266 

270 Xk EXPRESSION 

275 




--Mi DDT 



M10DT. 



13:44 JUNE 22, 1966 



100 
105 
110 
115 
120 
125 
130 
135 
1 40 
1/15 
150 
155 
1 60 
155 
1.70 



LAST CHANGE HERE- 






20/6/66 



.sk 



INTRODUCTION- TO OOLRy OOT 



* 



THE FOLLOWING FILE CONTAINS A RESCEIPTIGN CF THE INITIAL DDT PACKAGE 
t«" HE PROVIDED GN THE GE/625.' THE PURPOSE- OF THE SYSTEM! IS TO. 
PROVIDE THE USER WITH CONVENIENT MEAN? TO: 



rro 


190 


1.95 


200 


205 


2 1 


215 


220 


s t .*' t ^) 


230 


23 5 


24 



2 50 
255 



i.-yj 



A) 



ro 






IE ACE A PROGRAM BY PRINTIN' 



THE CONTENTS 



? ELECT EO 



REGISTERS. (••?, MEMORY LOCATIONS, AT SELECTED TI>*ES O-JRIMG A RUM 
OF THE PROGRAM.' PRI NT.01JT OF OPERATI ON CODES AMD ADDRESSES 
MAY PE IN SYNBOLIC F0RM,' AS IN THE ORIGINAL SOURCE PROGRAM, 
IF DESIRED. ■ . . . ■; ' - : .. 

PATCH ANY DESIRED CORRECTIONS OR CHANGES I WTO ANY LOCATION 
IN' 'THE ASSEMBLED PROGRAM. THIS CAM BE DONE WITHOUT 
EEAGSENRLING THE PROGRAfl. 'THE- CHANGES CAN BE WRITTEN IN 
THE SAME SOURCE LANGUAGE AS THE ORIGINAL PEOGRA:^ ME I THE 1 ":. 
OCTAL NOR'BINARY~PATCHEG ARE .REQUIRED. 

EMBED . "BREAKPOINTS" J.N THE PROGRAM. WHEN A BREAKPOINT HAS 
BEEN REACHED A SPECIFIED •NUMBER OR- TINES IN THE RURNING . 3F ' 
A PROGRAM, EXECUTION CEASES, THE BREAKPOINT MESSAGE:. 
"BREAKPOINT AT LOCATION XXX XXX" IS PRINTE r » 5 SELECTED • 



MEMORY LOCATIONS ARE PRINTED, AND DDT 



iOUESTS FURTHR 



COMMANDS FROM THE -USER \0 CONSOLE. "'-THE USER MAY AT THAT 
POINT ADD OR DELETE BREAKPOINTS, MAKE ADDITIONS OR 
CORRECTIONS, TRANSFER TO A DIFFERENT POINT IN THE PROO-AF-L, 
PRINT OUT MEMORY OR REGISTERS, OR SIMPLY RESUME EXECUTION.. 

•IN LIEU OF THE ABOVE HANDLING OF A BREAKPOINT, THE USER >-«Ay 
SPECIFY THAT THE .BREAKPOINT MESSAGE AND THE SELECTED 
LOCATIONS ARE TO BE PRINTED AT EACH ENTRANCE TO THEBREAK- 

. POINT, BUT THAT EXECUTION OF THE PRO GO. *M IS NOT TO RE 
INTERRUPTED UNTIL A SPECIFIED NUMBER OE PASSES THRU THE 

■ BREAKPOINT HAVE OCCUEED. . . ' 

0) EVENTUALLY IT WILL BE POSSIBLE, BY TYRING A SINGLE SPECIAL 
CHARACTER YET ' TO • BE SELECTED, TO HALT EXEOUTKM GF A EiRmM: 



i !v."0 :\ :i '1 



AND GIVE CONTROL T^ DDT, WHICH WILL BEHAVE. JUST A. c 



IT WOULD HAD IT" ENCOUNTERED A BREAKPOINT. 



340 

345 
350 
355 

J 

375 
380 
335 
390 

3^5 
400 
405 
41 

41 5 
420 

42 5 
430. 
435 
440 
445 
450 
455 

,460 
455 
470 
475 
400 

-'•c -, 



THE OHLY RESTRICTION' ON A ' USER' S PROGRAM' TO INSURE COMRATI n ILI TV 
WITH DDT IS THAT ALL SYMBOLS SHOULD BEGIN. WITH A LETTER. A SYi-BL 
THAT REGIES WITH A NON-LETTEE CHARACTER MAY NOT 3E REFERENCED IN ., 
A DOT COMMAND. • '■■ . ; ' 

TO RUN A PROGRAM (WHICH' MUST BE STORED IN ASSEMBLED, BINARY FORM) 
UNDER DDT, THE USER MUST. GIVE THE FOLLOWING COMMAND TO THE ■ KOLDY 
EXECUTIVE. "RUN DDT". WHEN DDT RESPONDS WITH A "DDT. READY", IT 
WILL ACCEPT COMMANDS - A "LOAD" BEING THE OBVIOUS FIRST CHOICE. 



J 

500 
505 
510 
515 
520 
525 
550 
535 
540 
54 5 
550 
555 
560 
565 
570 
575 
530 
585 
590 
595 
600 
60 5 

1 

630 



FORMAT OF DDT COMMANDS' 



ALL' COMMANDS. .TO DDT WILL TAKE THE. FOLL^WI NO , FORMAT: 

<OPTIONAL ■ TEMPORARY OUTPUT NODE MODIFIER> ,<COMMA^D NAi(E> 

^a qtotuq "PT A^^JIV'TMVc ci?'} a c> AfTT^ r> v CtTMT -fVM CMC-a. ^-mcta _tm[ ao A.^vrr 



THE ONE' EXCEPTION TO THIS FORMAT WILL BE THE SINGLE-CHARACTER COt'M.V'O 
REFERRED TO IN D) ABOVE. ' •. /■ ' 

FOR THE' COMMANDS "CONTINUE" AND "REGISTERS",' THE ARGUMENT STRING 
IS OPTIONAL. FOR ALL COMMANDS EXCEPT "DUMP" AND "REGISTERS", THE 
TEMPORARY OUTPUT NODE MODIFIER WOULD BE MEANINGLESS. ''■ - 

NORE THAN ONE COMMAND MAY. BE TYPED ON A LINE, AND A COMMAND 
NAY EXTEND OVER MORE THAN ONE LINE. . 

F^R THE- EXAMPLES IN THIS FILE,- THE- NUMBER. SIGN [.*■] WILL BE USED AS 
THE META -CHARACTER. 



:& :!< & Jfi >'< 



A NOTE ABOUT NUMBERS 



* 



ALL NUMBERS APPEARING IN DDT COMMANDS ARE TAKEN TO BE. OCTAL •" 
UNLESS SPECIALLY INDICATED OTHERWISE. FOR A FEW INSTRUCTIONS, 
SUCH AS "DEC", THE ACCOMPANYING NUMBERS ARE AUTOMATICALLY 
ASSUMED TO BE DECIMAL. TO OTHERWISE ENTER NON-OCTAL NUMBERS, 
OR OCTAL NUMBERS WHERE' ANOTHER TYPE IS EXPECTED, USE'ONE 
OF THE : FOLLOWING FORMS: 

NNNNNN : ; NUMBER TAKEN AS OCTAL ' ' 

NNNNNN. • '' NUMBER TAKEN AS -DECIMAL 

NNNNNN. MM \ NUMBER TAKEN AS FLOATING POINT : 



MOLDY DDT HAS A LIMITED COMPETENCE IN ARITHMETIC. IT RECOGNIZES 
"+'* AND "-" IN CALCULATING ADDRESSES AND CONSTANTS. EXPRESSIONS 
SUCH AS:' (ADR1+P0SN7-SIZE) ARE ACCEPTABLE. ' • * ■ ■ . 



CONTINUED IN r»2 DDT 



OLD 

OLB PROBLEM NAME--M2DDT 

READY. 

\ r> -p 



\<2. DDT i;5:5o JUNE 22, 1 966 

100 LAST-CHANGE HERE. 1934,. 20/6/66 B 

105 ■ ' • 

110 ■'■..:■.'. 

115 • • 

■130 • 

195 * * * * * * - ' DETAILS OF CONNANDS'' AVAILABLE • * * * * * * 

1-30 

135 

14 0- ' • 

145' LOAD <PEOGRAM NAME>, <PASSwORD>; <PRDGRAM NA^E>,<BASSV/GRD> '..... * 



150 
155 
1 60 
165 
170 
175 
ISO 
185 
190 

"^' 

v> ro 

215 
220 
225 

o ?n 

235 
2/i o 

245 
250 
2 5 5 
2 60 
2 65 
270 
275 
200 

/■' o ? 

290 

2^5 
300 
305 
310 

31 5 

32 



3/! o 

54 5 
350 
355 



IF THE PASSWBRD(S) ARE CORRECT, THE NAMED PEOGRA^(S) 
■-. IN ASSEMBLED; BINARY F^RM - -ARE LOADED INTO CORE FRO* 
SECONDARY- STORAGE. THE . PROGRAMS MUST ALL RE OF THE ."SAFE 
TYPE - ABSOLUTE OR RELOCATABLE. ONLY ONE CORE I?* APE-. 
NAY RE LOADED. . • ' 

XANPLE. . LOAD PROG 1 , SHAZAN; SB ILLS , IRO.N*; PUNCHR, CUFFS? : ■ 

THIS VGULR LOAD THE THREE PROGRAMS ."PROG i " , "DRILLS" , 
'AND "PUNCHR" IF "SHAZAN" ,• "IRON?'!", AND' "CUFFS" v;E*E 
THE CORRECT PASSWORDS RESPECTIVELY.' 



FOEFAT <N9DE> '# 

THE SINGLE ARGUMENT IS ONE OF THE 8 OUTPUT tlODE SYMBOL'S. 
LISTED DRLjwW. WITH ONE EXCEPTION, ALL OUTPUT WILL RE 1^ 
THIS NODR UNTIL A'' NE : ' ? FORMAT COMMAND IS. GIVEN.- 
' -THE EXCEPTION IS: IF A COPLAND IS PRECEDED BY A N OUTPUT 
MODE SYMBOL, THE OUTPUT PRODUCED BY THAT SINGLE COMN/V'D 
WILL BE-IN THAT NODE. WHEN THE OUTPUT 7'riW THE'SINGLE. 
COMMAND IS COMPLETED, THE OUTPUT 'MODE VILL REVERT TO THE 
r^ODE SPECIFIED IN THE LAST FORMAT -CfW'AWD . 



EXAMPLES; 



FORMAT SYN# 



OR: 



17 .-iO r-fl ,\ T A Q P :'i 



DUnP < ADDRESS LIST> ' # 

EACH ELEMENT OF THE ADDRESS LIST IS EITHER A SINGLE ADDRESS 
EXPRESSION, OR A- PAIR OF ADDRESS EXPRESSIONS SEPARATED BY 
CONNAS. THE ELEMENTS OF THE ADDRESS LIST' ARE SEPARATED by 
SEMI -COLON'S. THE CONTENTS OF EACH SINGLE LOCATION- AND -OF 
EVERY LOCATION BOUNDED CI NCLUSI VELY] ~By"'tHE ADDRESS -PA I PS , 
ARE PRINTED IN THE CURRENT OUTPUT NODE. ANY; 'NUMBER ■ .?.? 
ADDRESSES OR ADDRESS-PAIRS MAY BE USED AS ARGUMENTS T0 A 
DUMP COMMAND. 



THIS WOULD PRINT THE CONTENTS OF' THE FIRST 20 ' 
^LOCATIONS OF THE ROUTINE GETPT, PLUS LOCATIONS PT! 
AMD PT2, ALL IN THE OUTPUT .iW.DE SELECTED BY THE 
LAST "FORMAT" COMMAND. 



FORMAT SYi'tf DUMP CETET, 0E.TPT-H'9.#TAL DUMP PT1 ; PTR£ 
RUMP ST0PT,ST0P1 ;ST'JFFr* 

THIS WOULD' PR PIT THE CONTENTS OF THE FIRST 9.0 '■■ ' 
LOCATIONS OF-THE ROUTINE ■ GETPT Pi THE SYMBOLIC OUTPUT 
MORE, THEN THE LOCATIONS PT! AND R?> IM THE TALLY 
iv;pF)E 5 . THEM THE LOCATIONS FROM STORT TO AND INCLUDING 
STORT! IN THE SY-' :n OLIC MODE, TME'-i- THE LOCATION STUFF 
IN THE SYMBOLIC MODE. • '.'■"' 



PATCH <SINOLE ADDRESS EXRRESSION> ; :< A LIST, OF WORD EXPRESS I''^S> -.? 

■ THE WORD EXPRESSIONS, WHICH.', ARE SEPARATED VTl^'fi EACH OTHER 
• .RY SEMI-COLOUS, REPLACE THE' CONTENTS OF SEQUENTIAL MEMORY 
LOCATIONS STARTING AT THE' ADDRESS OIVEN'IU THE 
• FIRST ARGUMENT; EVENTUALLY, CERTAIN Oh^R RSEURO-OREEATI :-"MS 
.•MAY RE ALLOWED TO REPLACE A W;ORO EXPRESSION AS AM ARSUMEMT. 

EXAMPLES: PATCH MASK+3 ; 777777777000* -' ' ._ ' ' 

. ■ .THIS WOULD' REPLACE WHATEVER HAD. REE*! I.N LOOATTOO 
. MASK+3 WITH THE OCTAL CONSTANT 7.7.7777777000. 

PATCH JESTER~3;LDA GET, ID;CMRA"0U-TEr'TZE TF-Aj* . 

THIS WOULD REPLACE WHATEVER HAD REEN I M LOCATIONS 

• • JEST-ER-3' WITH' LDA GET, ID • ■'■'' 

JESTER-?. WITH " CMRA.OUOTE 

■JESTER.-! WITH TZE TF4 '.' 

PATCH RARF-H!;TRA RAT;* '..PATCH RAT;LDX A,FO0;ADX A, 5 ,=011; 
TRA . !?ARF+1S# 

THE ORIGINAL INSTRUCTION tkt LOCATION ' BAR F+.9 (.DECIMAL) 
[REMEMRER THAT THE RARF-H ! IM THE PATCH COMMAND IS' 
.''■'. ' 0CTAL3 WOULD RE EXRUNOED. THE PROGRAM WOULD TRV\'SFE~ 
TO THE INSTRUCTION IN- LOCATION RAT. "RAT" MUST )\^VE 
REEM DEFINED SOMEWHERE AMD THE THREE- LOCATIONS R-T, 
' • PAT+1,' AND PAT+R MUST RE AVAILABLE .FOE" OVERWRITING , .. 

AS' ANY CONTENTS THEY -MAY HAVE HAD WOULD RE DESTROYED 
RY THE SECOND- PATCH COMMAND. 



GO 5 



CONTINUED IN M3 DDT 



OLD- 

0LD PROBLEM NAME--M3DDT 

READY* 
LIST 

M3DDT. 13s49 .JUNE" 22 p l 966 

100 -LAST CHANGE -HERE* 1.S31, 20/6/66 

105 

110 

U5 '..■..■.....;■. 

•120 '■' ■ 

125 ■'. 'BREAK <A [ 1) ' 9 l i 1) <>L [I ) 9 Ui 13 > $ .'. <A'£23 9 1 [23 9 L[2 3- 9 UE 2 3> % • •••■ 5 

130 '■ <Aa , 3,nN3 3 L(N3pU1^3> 

135. ; 

140 THERE ARE RESTRICTIONS ON THE LOCATING OF BREAKPOINTS? 

145 • THESE ARE GIVEN AT THE END 0F THE SECTX0N DEALING WITH 

150 ." THE BREAK COMMANDS. • 
155 

160 ' "A SINGLE BREAK COMMAND CAN" EMBED AMY NUMBER- 0F BREAKPOINTS* 

165 EACH -BREAKPOINT. SPECIFIED TAKES A' LIST OF 1 TO 4 ARGUMENTS, 

170 SEPARATED/BY C0MMAS o THE ARGUMENT LISTS FOR -DIFFERENT 

175- • BREAKP0INTS ARE SEPARATED BY "SEMI -COLONS*/ AS THE ACTION 

ISO DEPENDS 0N THE DUMBER 0F ARGUMENTS SUPPLIED, FOUR CASES 

185 ARE CONSIDERED* 
190 • 

195 IN EACH CASE THE FIRST ARGUMENT* ACN3, IS THE ADDRESS AT 

200 . WHICH THE BREAKPOINT IS INSERTED* IF A[N3 IS THE ONLY 

205 ARGUMENT SUPPLIED, THE PR0GRAM HALTS „ DDT PRINTS THE 

210 ' BREAKPOINT MESSAGES , e 'BREAKP0I NT AT LOCATION AEN3", AND 

215 - AWAITS A COMMAND FR0M THE CONSOLE* THE INSTRUCTION IN THE 

220 LOCATION WHERE THE BREAKPOINT IS INSERTED IS N0T EXECUTED 

225 • BEFORE THE BREAK TAKES PLACE 
230 

235 -EXAMPLES? BREAK CRUNCH^ 
240 

'245 WHEN -THE PROGRAM REACHES -LOCATION CRUNCH,. THE 

250 INSTRUCTION THEREIN IS NOT EXECUTED* THE MESSAGE 

255 "BREAKPOINT AT LOCATION" CRUNCH" IS PRINTED. THE 

260 SYSTEM AWAITS A TYPED COMMAND, WHICH DETERMINES THE 

265 NEXT ACTIONo IF, FOR EXAMPLE,, THE USER TYPES IN THE 

270 ," ' COMMAND "CONTINUE" (WITHOUT ARGUMENT), THE INSTRUCTION 

275 IN CRUNCH IS EXECUTED* AND THE PROGRAM CONTINUES* 

2S0 • THE BREAKPOINT REMAINS SET S SO THAT THE PROGRAM IS 

2S5 AGAIN INTERRUPTED IF AND WHEN. CRUNCH IS REACHED AGAIN* 
son 



305 THE ACTION IS IDENTICAL T0 THE PRECEDING EXAMPLE., 

310 EXCEPTING THE APPROPRIATE CHANGE OF LOCATION IN THE 

315 MESSAGES IT OCCURS ON EVERY ARRIVAL AT SNAP, CRACKL 

320 0R P0Pc 

525 • . 

330 . 

335 

340 BREAK COMMAND WITH 2 ARGUMENTSs 

345 . " 

350 IF TWO ARGUMENTS, A EN 3 AND 1 1 N 3 -, ARE SUPPLIED TO THE BREAK' 

355 C0KNAND, A CM 3 IS AGAIN THE ADDRESS WHERE THE BREAKPOINT 

360 '■ IS "■ INSERTED, AND I CN 3 IS THE "ITERATION COUNT"* 

370 IF ICN3>0 5 THE BREAKPOINT IS IGNORED- EXCEPT THAT I£N3 IS ■ 

375 DECREMENTED BY ONE EACH TIME THE PROGRAM REACHES LOCATION 

380 A[N3o WHEN I IN 3 REACHES ZERO, OR IF THE PROGRAMMER HAS 

385 • . SPECIFIED ICN.3=0 9 BREAK ACTION TAKES PLACE AS IF NO ICN3 

390 HAD BEEN SPECIFIED* 
■ 395 " 

400 ' IF ITN3 HAS BEEN SPECIFIED <0, 0N EMM PASSAGE THRU LOCATION 

405 A[N3 THE BREAKPOINT MESSAGE IS PRINTED AND I CM 3 IS 

410 INCREMENTED -BY !.• WHEN ILN3 REACHES ZERO, BREAK ACTION 

415 TAKES PLACE AS IF N0-ICN3 HAD BEEN SPECIFIED* 
420- ! 

425 IF I EN 3=0, IT IS NOT FURTHER INCREMENTED OR DECREMENTED..' 

430 • ' . 

435 

440 EXAMPLES BREAK- VIEWER ,-39«B N0W333 9 O§SEEERpSIGHT+770- 

445 . . . ' 

450 THE ACTI0N3 0N EVERY ARRIVAL AT LOCATION • VIEWER, • 

455. THE BREAKPOINT MESSAGES "BREAKPOINT AT LOCATION 

460" • . VIEWER" IS PRINTED?, 0N THE 40TH AND SUBSEQUENT' 

455 "■ ARRIVALS, CONTROL IS ALS8 TRANSFERRED TO 'THE CONSOLE, 

470 " 0N EVERY ARRIVAL AT L0CATI0N N0W333, THE BREAKPOINT 

475 - MESSAGES "BREAKPOINT AT L0CATI0N N3W333" IS PRINTED, 
4S0 . "•■■■.• AND C0NTR0L IS TRANSFERRED TO THE CONSOLS, 

485 . -0N THE <SIGHT-!-S4>TH AND SUBSEQUENT ARRIVALS AT LOCATION 

•490 /SSEERp THE BREAKPOINT MESSAGES ''BREAKPOINT AT L0CATI0N 

495 •'■••*...' SEEER W IS PRINTED, AND C0NTR0L IS TRANSFERRED TO THE 

500 CONSOLEo 

505 ' . 

510 THE ABOVE EXAMPLE ALSO .ILLUSTRATES THE DECIMAL AND 

515. . OCTAL NUMBER CONVENTIONS,, THE S C IN'°M0W333$ C IS 

520 ACCEPTABLE, .BUT WITHOUT EFFECT, AND COULD BE OHITTEDo' 
525 
530 
.535 

•540 BREAK COMMANDS WITH 3 AND 4 ARGUMENTS? SEE NEXT FILE 
545 
550 
555 CONTINUED IN M4DDT 



0LD 

OLD PROBLEM NAME--M4DDT 

READY. 

LIST 

M4DDT 13:50 JUNE 22,1966 

100 LAST CHANGE HERE: 1833, 20/6/66 '. 

105 . 

110' 

115 
120 

125. BREAK COMMAND WITH 3 ARGUMENTS: 

130 v • 

135 IF THREE ARGUMENTS ARE SUPPLIED- 10 THE BREAK COMMAND, A[N3 

.140.- -AND HN3 ARE AGAIN" THE ADDRESS WHERE THE BREAKPOINT IS TO 

145 BE INSERTED AND THE ITERATION COUNT RESPECTIVELY^ THE . 

150 THIRD ARGUMENT 3 LCN 3 , . IS -THE ADDRESS -OF A LOCATION WHOSE 

155 C0NTENTS WILL BE PRINTED OUT ALONG WITH THE BREAKPOINT ' 

160 MESSAGE WHENEVER THAT IS PRINTED. SEE THE 2-ARGUMENT 

165 BREAK 'COMMAND FOR DETAILS OF THE SIGNIFICANCE OF HN3-. 
170 

175 EXAMPLE: . BREAK SMASH',1 7 , JUNKIE ;CRASH ,0,MUSH ;. EXAM ; L4S ,-3,'F3UN# 
180 

185 ' THE ACTION: ON HE 16TH 'AND SUBSEQUENT ARRIVALS AT 

190 s LOCATION SMASH , .THE BREAKPOINT MESSAGE: "BREAK- 

195 P0INT AT LOCATION SMASH" AND. THE CONTENTS 0F 

200 • • 10CATI0N JUNKIE ARE PRINTED, AND CONTROL IS 

205 ' - 'TRANSFERRED TO THE CONSOLE; 

210- 0N EVERY ARRIVAL AT -LOCATION CRASH, THE BREAKPOINT 

215 MESSAGE: -"BREAKPOINT AT LOCATION CRASH" AND THE 

220 CONTENTS 0F LOCATION MUSH ARE PRINTED, AND CONTROL 

225 IS TRANSFERRED TO. THE CONSOLE; 

230 ON EVERY ARRIVAL- AT LOCATION EXAM, THE BREAKPOINT 

235 • -MESSAGE: "BREAKPOINT AT LOCATION EXAM" IS PRINTED, 

240 . AND CONTROL IS TRANSFERRED TO THE CONSOLE; 

245 s ON EVERY ARRIVAL AT LOCATION L3S , THE BREAKPOINT 

250 MESSAGE: "BREAKPOINT AT LOCATION LOS" AND THE 

255 " CONTENTS OF LOCATION FOUN ARE PRINTED; 

260 ON THE FOURTH AND' SUBSEQUENT ARRIVALS AT LOCATION 

265 • ' . . L3S, CONTROL IS TRANSFERRED TO - THE CONSOLE . 

270 ' . ■ , 

275 ' ■ ■ '. 

280 . ' 

285 BREAK COMMAND WITH 4 ARGUMENTS: ' 
290 

295 IF FOUR ARGUMENTS ARE SUPPLIED TO THE BREAK COMMAND, ATN3 

300 AND ICN3 ARE AGAIN THE ADDRESS WHERE THE BREAKPOINT IS TO 

305 BE INSERTED AND THE ITERATION COUNT RESPECTIVELY. THE 

310 THIRD AND FOURTH ARGUMENTS, LC N 3 AND UC N 3 , ARE THE L2WER . 

315 AND UPPER BOUNDS OF THE BLOCK OF MEMORY TO BE PRINTED OUT 
320 • ALONG WITH THE BREAKPOINT MESSAGE WHENEVER THAT IS PRINTED 

325 ALL LOCATIONS FROM LENT TO U[N 3 INCLUSIVE ARE PRINTED. ■■ 

330 SEE THE 2-ARGUMENT BREAK COMMAND FOR OiTAILS OF 

335 THE SIGNIFICANCE OF HN3. 



350 ''■'.■■ -98. ,SHELTR ,H0:]E# 

355 . • 

360 THE ACTION: 0N THE FBURTH AND SUBSEQUENT ARRIVALS 

365 AT L0CATI0N CHA0S , THE 3REAKP0INT MESSAGE: 

370 "BREAKPOINT AT L0CATI^M CHAOS" AND IKE CONTENTS 

■375 , 0F L0CATI0MS KEG THRU KEG+1 4 (DECIMAL) ARE PRINTED., 

380 • - : AND C0MTR0L IS TRANSFERRED • 10 THE C8NS0LE ; ■ 

385' . 0N , EVERY ARRIVAL AT L4CATI0N QUEST, THE BREAKPOINT 

390 MESSAGE: "3REAKP0INT AT L0CATI0N : QUEST""' AND THE 

395 CONTENTS 0F L0CATI0N PAND0R ARE PRINTED, AND CONTROL 

400 IS TRANSFERRED T3 THE CONSOLE; . 

405 • 0N EVERY ARRIVAL AT LOCATION SAFETY (IF Y0U EVER 

410 MAKE IT)- THE BREAKPOINT ' MESSAGE: "BREAKPOINT AT 

415 LOCATION SAFETY" 'AND THE CONTENTS 0F ALL L3CATT0NS 

420- * SHELTR THRU H0ME ARE -PRINTED; 

425 0N THE 99TC AND SUBSEQUENT ARRIVALS AT LOCATION 

430 ' SAFETY /CONTROL IS ALS0 TRANSFERRED . T0 THE CONSOLE. 

435 
440 
445 

450 * * * * * RESTRICTIONS ON BREAKPOINT LOCATION. ' * * * .* * 

455 

460- ' 

465 IN 0RDER 73 ESTABLISH THE 3REAKP0INT, DDT &3VES THE INSTRUCTION 
470 ORIGINALLY F0 UND ■ IN THE BREA.KP0I NT L0CATI0N'T0 AN UNSPECIFIED 
475 LOCATION, AND REPLACES IT WITH A TRANSFER T0 THE DDT R0UTINE 
480 WHICH EXECUTES THE- BREAK. THIS "DJES ' I\BT APPEAR TO THE USER; 
485 DUtfPS , PATCHS, ETC., W0RK AS IF HE ORIGINAL INSTRUCTI0N WAS WHERE 
490 IT STARTED. UNBREAKING RESTORES THE ORIGINAL INSTRUCTI0N TO ITS . 
495 RIGHTFUL PLACE. 
500 

505' DDT, THEREFORE,. HAS DIFFICULTY COPING WITH BREAKPOINTS PLACED- 
510 AT INSTRUCTIONS WHICH DEPEND -.0N THEIR LOCATION FOR PROPER 
515 EXECUTION. IC MODIFIED INSTRUCTIONS CAN BE ."ACCEPTED AS LOCATIONS 
520 F3R BREAKP0INTS , BUT THE F0LL0WING ARE PROHIBITED PLACES : 
525 " . . " 

530" ■;. 1) ' PROGRAM EDIFIED LOCATIONS , • 

535 

540 .-.2) INSTRUCTI0NS TO- BE EXECUTED BY AM XEC 0R XED 

545 • • ' " 

550 ' . 

555' '■•■■■ " 

560 ■•.■■■■ .' ■ • 

565 UN3REAK <ADDRESS ' UST> # ■' 
57.0 

575 THE ADDRESS LIST l-IAY BE. 0MITTED, OR AAY C3NTAIN ANY NUMBER 

580 0F SINGLE ADDRESSES SEPARATED BY SEMI -COLONS. . ' IF NO ADDRESS 

585 ' LIST IS SUPPLIED, ALL BREAKPOINTS ARE REMOVED; • OTHERWISE 

590 THE BREAKPOINTS ARE' REMOVED FROM .THE ADDRESSES SPECIFIED. 

595 ' 

600- EXAMPLES: UNBREAK CHAOS ;SAFETY# 
605 

.610 THIS WOULD EXPUNGE THE FIRST AND LAST BREAKPOINTS' 

615 INSERTED' BY THE PRECEEDING EXAMPLE;. THE BREAKPOINT 

620 • AT 'QUEST 1 W0ULD REMAIN. 

62 5 

630 • UNBREAK # 

635 • ; . 

640 • THIS W0ULD EXPUNGE ALL BREAKP0INTS CURRENTLY SET . 

64 5 • - 

650 ' 

655 • 

660 
665 
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0LD 

OLD PROBLEM NAME — M5DDT 

READY. 

LIST 



13:53 JUNE 22, 1956 
LAST CHANGE HERE: 1 90C , 20/6/66 



CONTINUE <0PTI0NAL ITERATION C.0UNT> ;#' 

EXECUTI0N : 0F. THE PROGRAM RESUMES." THE NEXT INSTRUCTION 
•EXECUTED IS THE INSTRUCTI ON -AT THE BREAKPOINT LOCATION. 
IF THE OPTIONAL SINGLE ARGUMENT IS SUPPLIED, THIS REPLACES 
THE ITERATION- COUNT, ICNX, FOR THIS. -BREAKPOINT. 



EXECUTION 0F THE USER'S PROGRAM CONTINUES FROM THE 
• BREAKPOINT INSTRUCTION, WITHOUT .'FURTHER CHANGES. 

CONTINUE -9. # 

EXECUTION 0F THE USER'S PROGRAM CONTINUES FROM THE 
BREAKPOINT INSTRUCTION: THE" ITERATION COUNT, ICN],' 
FOR THIS BREAKPOINT IS RESET TO -9. 



M5DDT 

100 
105 
110 
115 
120 
125 
130 
135 
140 
145 
150 
155 
xSO EXAMPLES:.' CONTINUE # 

;s5 • 

175 

180 

185 

190 

195 

200 

205 

210 

215 

220 

225 

230. 

'235 

240 

245 

250 

255 

260 

265 

270. 

275 

2R0 

>0 

300 
305 
310 
315 



TRANSFER <S INGLE ADDRESS EXPRESSIONS # 

•EXECUTION OF THE PROGRAM COMMENCES, OR RESUMES, AT THE ' 
INSTRUCTION IN THE- LOCATION WHOSE ADDRESS IS SUPPLIED AS 
THE SINGLE ARGUMENT. THUS, AFTER A BREAK HAS BEEN 
• EXECUTED, CONTROL MAY BE TRANSFERRED TO ANY LOCATION 
DESIRED. ' ... 

EXAMPLE: TRANSFER TA?.END-TABLEN-f3 .# 

IF ISSUED 'AFTER- THE INITIAL LOAD, EXECUTION OF THE 
PROGRAM COMMENCES AT '(TABEND-TABI r EN+3) • IF ISSUED 
AFTER CONTROL HAS BEEN. TRANSFERRED TO THE CONSOLE 
AT. A BREAKPOINT, EXECUTION OF THE PROGRAM RESUMES . 
AT (TA3END-TABLEN+3) , RATHER THAN AT THE INSTRUCTION 
AT THE BREAKPOINT, AS WOULD BE THE CASE WITH ' A 
. "CONTINUE". 



\o- 



335 REGISTERS <OPTI ONAL LIST OF REGISTER IDENTIFIERS # 
340 . • 

345 ' THE ARGUMENT LIST, IF SUPPLIED, IS A LIST 0F REGISTER . 
350 IDENTIFIERS- (A, 0, 4, ETC) SEPARATED By SEMICOLONS. THE-- 

v355 . CONTENTS OF THE REGISTERS SPECIFIED ARE PRINTED. TF NO 
,360 ARGUMENT IS SUPPLIED, THE CONTENTS. OF ALL REGISTERS 

\<S5 CA, Q, E, BAR, IR, TR, IC, XO, Xl, , X7) ARE PRINTED. 

,370 THE INDEX REGISTERS XO., XI, ETC., ARE SPECIFIED IN THE 

375 ARGUMENT LIST BY NUMBER ONLY, N3TAS XN. \- • 

380. ' . . . • . . 

3*5 EXAMPLES: REGISTERS E:C:2 #. . ■ / ■' ' 

390 

395 THE CONTENTS OF THE THREE REGISTERS: E, 

400 Q, AND X2ARE PRINTED. 

405 ■.■■.-... ' ' . , 

410 REGISTERS # 

415- 

420 THE CONTENTS OF ALL REGISTERS ARE PRINTED. 

425' 

430 

435 

440 

445 ALTER REGISTER; IDENTIFIER ,EXPRESSI0N>: . ,..* ; 

.450 <REGISTER IDENTIFIER, EXPRESSION^ • # 

455- - .• :■■■'■ 

'460 " THE CONTENTS OF EACH REGISTER SPECIFIED ARE REPLACED 

465' "BY THE CORRESPONDING EXPRESSION. . ' 

470 ..■■■■. 

475 EXAMPLE: ALTER Q,L0WBND ;5 ,03774 1 ; IC ,-TESTPj-E ,22. #■' 

480. ■■■■■■ 

485 • THE 'CONTENTS 0F THE: ' 

N \490 Q REGISTER ARE REPLACED By: • LOWRND 

/405 X5 . 03.7741 •• 

500 . . IC ' TESTP 

505 E '22CDECIMAD 

510 
515 

520 • • 

525 

530 SAVE <PR0GRAM NAME> # 
535 

540 THE PROGRAM(S)- CURRENTLY LOADED ARE SAVED UNDER THE NAME 

545 SUPPLIED. ALL BREAKPOINTS, PATCHES ,■ ETC. , ARE PRESERVED 

550 AS THEY STAND. 

555 ■ ' 

560 EXAMPLE: SAVE TRASH # 
565 
570. 
575 
580 
585 

590 '///// OUTPUT MODES AVAILABLE ' \ \ \ \ \ 
595 

600 ANY OF THE FOLLOWING 8 SYMBOLS. MAY BE SUPPLIED AS THE ARGUMENT 
605 TO THE "FORMAT" COMMAND: 
610 

615 SYM SYMBOLIC MODE. THE CONTENTS 0F THE LOCATION ARE PRINTED 
620 AS A MNEMONIC OPERATION CODE FOLLOWED BY A SYMBOLIC 

625 ADDRESS AND AN ADDRESS MODIFICATION FIELD. THE ADDRESS 

630 WILL BE PRINTED AS (NEAREST SYMB0L<ADDRESS+0CTAL 

635 CONSTANT) -IF NO SYMBOL ALONE APPLIES. IF THERE IS NO 

640 MNEMONIC WHICH CORRESPONDS TO THE OPCODE PORTION OF THE 

645 ' WORD, THE OUTPUT MODE IS CHANGED TO OCT FOR THE ONE WORD 
650 ONLY, AFTER WHICH IT REVERTS "TO SYM. .. 



660 


•' DEC 


665 




670 




675 


OCT 


680 




5#5 




j? 


FLO 


700 




705 


BCD 


•710 




715 




720 


ASC 


. 725 




750 




735 


HAL 


-.740 




745 




750 


TAL 


755 




760 




765 




.770 




.775. 




. 7R0 \ 




7p5 


IF YOU 


790 




795 




800 




805 




^10. 


^^^Jlfi^^Ci 



decimal mode. the contents 0f the location 1 . are printed 
as a fixed-point decimal constant 

octal mode. the contents of the location are printed as 
a fixed-point octal constant. 

floating point mode. the contents of the location are 
printed as a floating point constant . 

binary coded. decimal mode. the contents of the location 
are printed as 6 alpha-numeric. characters c 5 bits each) . ' 

ascii mode, the contents of the location are printed as 
a alpha-numeric characters (9 bits each). . ... 

half-word mode. the contents of the location are printed 
as; two' symbolic address expressions (13 sits ' each)v 

tally mode. the contents 0f the location are printed as 
a symbolic address, a tally count, and 6 modification' 
bits which will be printed as 2 octal digits. 



IF YOU HAVEN'T FIGURED IT OUT BY NOW, RETURN TO G0 AS THERE 

.AINT NO M0 



^.Sc^ifi^^c^>f::i:^^-:{c^:>k^*^^^>r:END MOLDY DDT^^^^^^"^^^^^^^'^^^^-^-^^^^^^^'^^^^^^^ 



G MAP—PHASE 
APRIL -20 j 1S66 



THIS DOCUMENT . CONTAINS A USER 'DESCRIPTION OF THE GMAP TO BE 
PROVIDED. ON THE' PHASE MOLD SYSTEM 

UPON RECEIVING CONTROL GMAP WILL REQUEST INPUT FROM THE 
TERMINAL, IN 0RDER T0 GET ITS 0PTI0N PARAMETERS (THESE MAY " BE 
TYPED WITH THE "RUN GMAP" COMMAND IF LISTEN OR OTHER INITIATING 
M0DULES PRESERVE AND' TRANSMIT THE REMAINDER OF THE' INPUT LINE) o 
AT LEAST THREE FIELDS, COMMA SEPARATED, ' WILL BE EXPECTED o ' THE 
FIRST FIELD UILL BE THE NAME OF THE SOURCE FILSo THE SECOND 
FIELD UILL BE THE NAME 0F THE BINARY OUTPUT FILE, UNLESS IT IS 
"NBIN- IN WHICH CASE N0 BINARY OUTPUT WILL BE ' PRSDUCEDo THE 
THIRD FIELD UILL BE THE NAME OF THE LISTING FILE UNLESS IT IS 
"NLSTOIP IN WHICH CASE NO OUTPUT LISTING WILL BE PRODUCED* AN 
OPTIONAL FOURTH FIELD MAY CONTAIN EITHER "SYMTAB" OR "N3YMIAB"*- 
THESE WILL FORCE OR INHIBIT RESPECTIVELY THE 0UTPUTING OF THE 
SYMBOL TABLE FOR ' DDT. IF IT IS NOT PRESENT NSYMTA3' WILL BE 
ASSUMED." 

SEVERAL FEATURES For' ■ GENERATING : ASCII CONSTANTS WILL BE 
PROVIDED* THE PSEUDO-OP "ACI" CORRESPONDS TO THE PSEUDS-OP W BCI CJ 
BUT PRODUCES-' ASCII RATHER THAN BCD .CHARACTERS*, THE "A" 
SPECCIFICATI0N IN LITERALS OR "\J?D" PSEUDS-OPS- ALSO GENERATES 
ASCIIo 

CERTAIN FEATURES OF GECOS GMAP WILL NOT BE PROVIDED. BECAUSE 
OF THE EXISTENCE OF A COMPREHENSIVE EDITING SYSTEM WITHIN THE 
OPERATING ENVIRONMENT THE FILE MAINTENANCE (I.Eo ALTER) FUNCTIONS. 
WILL BE DELETED* SINCE GMAP WILL BE INDEPENDENT 0F THE DEVICE ON 
WHICH THE FILE IS MAINTAINED, THE COMPRESSED DECK FEATURE WILL OF 
COURSE ALSO BE REMOVED*, -IN ADDITION, SYSTEM MACROS WILL NOT, AT 
LEAST AT FIRST, BE PROVIDED. ' 

INPUT WILL BE FREE FORMAT, FOLLOWING ROUGHLY TSAP 

CONVENTIONSs •_.''. 

<LAB£L>S<OPC0DE><SPACE><VARIABLE FIELD>"<:C0MMENT><5 OR "<CR»- . 

GMAP WILL" DEPEND ON THE FILE SYSTEM FOR COMMUNICATION WITH 
THE TERMINAL, FOR LOCATING USER FILES, FOR CREATING AND DELETING 
ITS SCRATCH FILE 9 AND FOR READING AND WRITING -ALL -FILES* ALL 
OTHER OPERATIONS WILL BE INTERNALS THE PHASE SYSTEM WILL 
REQUIRE AN INITIAL MEMORY ALLOCATION AND WILL NEITHER REQUEST NOR 
RELEASE MEMORY UNTIL TERMINATION. • 



0LD 

0LD.PR0BLEM NAME--LDINIT 

READY. 
LIST 

LDINIT 14:00 JUNE 22,1966 

6/21/66 (RPL) 

100 INITIAL. VERSI0N 0F THE M0LD' L3ADER 
110 
120 

130 THE FIRST VERSI0N 0F THE M0LD 10ADER WILL 3E MUCH "SIMPLER- THAN 
140 THAT DESCRIBED IN ML0AD1 AND ML0AD2. • TiE C0MMANDS WILL 3E . 
150 SIMILAR BUT SIMPLER. THERE. ARE THREE BASIC C0MMANDS: 
160 

170 '■■ 10AD NAME,PASSW0RD • 
180 ■ 

.185 START 

.186 

190 0PTI0N XXX;YYY;ZZZ 

200 XXX,YYY, AND ZZZ ARE. 0PTI0NS ■ FR0M '• THE LIST THAT F0LL0.WS . 

210 • ' ' 

220 THE .0PTI0NS ARE: . - 
230 . ■ 

240 MAP THIS- WILL CAUSE. A MEM0RY MAP T0 BE PRINTED '0N THE TELETYPE. 

250 ■ ' 

260 C0MM0N N THIS WILL CAUSE A 3L0CK 0F N W0RDS 10 .BE RESERVED AS ,. 

270 • C0-MM0N AT THE BEGINNING 0F THE PR0GRAM . THIS MUST' 

27 5 • 0N THE TELETYPE. 

280 " . APPEAR BEF0RE THE FIRST PR0GRAM IS LEADED IF IT IS 

290 '10 BE USED. 

300 

310 USE- NAME (N) THIS WILL 'CAUSE THE SYM30L NAME T0 BE ENTERED I NT0 

320 THE 10 AD TABLE AS A LABELED C0MM0N- REG ION 0F SIZE N, A 

330 ■ BL0CK.0F N W0RDS WILL 3E RESERVED AT THIS P0INT IN THE 

340 PR0GRAM F0R THE LABELED C0MM0N REGION. 

350 

360 'BEGIN SYMDF THIS WILL-CAUSE THE. L0CATI0-N 0F THE SYMBL0 SYMDF 
370 • 10 BE TAKEN AS THE TRANSFER ADDRESS INT0 THE PR0GRAM. ■ THE 

380 SYMB0L SYMDF MUST BE DEFINED AS A SYMDEF IN 0NE. 0F THE 

390 .' PR0CEDURES BEING L0ADED. 

400 

410 . 0RIGIN N THIS WILL CAUSE THE PR0GRAM TJ BE L0ADED WITH A BASE 
415 ADDRESS 0F N (ALL PR0GRAMS WILL BE L0ADED AS SLAVE ' 

420 PR0GRAMS). THE FIRST PR0CEDURE WILL BE L0ADED AT SCLAVS 

430 ADDRESS 64, 0R A3S0LUTE ADDRESS NK-64... IF N IS N3T 

440 SPECIFIED THE BASE ADDRESS WILL 3E AT 1024. 

450 

460 T0 10 AD A PR0GRAM Y0 U MUST FIRST SPECIFY THE 0PTI0NS Y0U WANT T* 
470 USE BY THE 0PTI0N C0MMAND. IF Y0U i? Q3 mi NEED ANY FINE. 
480 Y0U THEN USE THE JJ3AD. C0MHAND. AFTER ' THE ' PR0GRAM HAS BEEN 
490 L0ADED Y0 U CAM EITHER RUN IT' BY USING THE START .C0MMAND 0R L0AD 
500 -AN0THER PR0GRAM WITH THE' 0PTI0N AND ■ L0AD C0MMANDS . 
510 



PLD ' 

OLD PROBLEM NAME-- MLOADS 

READY. 
.;<-LIS 
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100 
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J9.Q 
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390 
400 
410 



OLD 

OLD PROBLEM NAME— -ML0AD1 

READY. 

LIST. ' . * 

ML0AD1 14:06 JUNE. 22,1966' 

.6/20/66 CRPL) 
100 MOLD LOADER 
105 

110 

115 THE-- MOLD LOADER WILL BE A MODIFICATION OF GEL0AD, THE LARGEST 

120 CHANGE WILL BE THE ELIMINATION 0E THE DEBUG FEATURES AND THE 

125 ADDITION 0F CERTAIN ■ OPTIONS TO CREATE A FILE WHICH IS A" CORE' 

130 IMAGE- GIF SOME PROGRAM. MOST OF. THE OTHER GELOAD OPTIONS WILL 

135 STILL BE AVAILABLE. ^ 

140 

145 . 

150" LOADER COMMANDS 

155 

160. LOAD Ml ,P1;N2,P2; ...;NN,PM • 

165 

170 . THIS IS THE COMMAND TO LOAD WITH STANDARD OPTIONS. ■ THE 

175 N'S ARE FILE NAMES- AND THE P'S ARE PASSWORDS. THE FILE 

180 NAMES AND 'PASSWORDS ARE SEPARATED BY- COMMAS AND DIFFERENT • 

185 . FILES ARE SEPARATED BY SEMI-COLONS. PASSWORDS ARE-.' 

190 OPTIONAL. IF- THE FILE DOES NOT NEED ONE USE A SEMI-COLON 

191 AFTER THE FILE NAME IF MORE FILES ARE TO FOLLOW. 
195 

200 • OPTION XXX;YYY;ZZZ , 

205 ' 

210 IF IT IS NECESSARY TO USE SOME OPTIONS OTHER THAN THE 
215 STANDARD ONE-'S THEY MUST .BE SPECIFIED BEFORE THE LOAD 
220 COMMAND. THE' fJEXT LOAD COMMAND WILL THEN BE EXECUTED WITH 
.225 SPECIFIED OPTIONS. THE OPTIONS SHOULD BE SEPARATED 3Y ■ 
230 . SEMI-COLONS SINCE SOME OF THEM WILL HAVE IMBEDDED COMMAS. ' 
235 A. LIST OF OPTIONS FOLLOWS WITH THE STANDARD OPTIONS SPECIFIED 
240 

245 1-.. MEMORY MAP OPTIONS •• 

250 
255 NOMAP. NO MEMORY MAP IS PRODUCED.- THIS IS STANDA'RD. 

260 MAP XXX PRODUCE A MEMORY MAP AND PLACE' IT IN FILE XX*. 

261 • THIS FILE (EXCEPT FOR TTY) MUST BE ONE THAT DOES 
N< ?62 -NOT ALREADY EXIST. IN THE USERS CATALOG. 



c 



2*0 N0G0 DOES NOT EXECUTE AFTER LOADING.-' THIS IS STANDARD. 

285 ' THE LEADER WILL WAIT FOR ANOTHER COMMAND. THIS COULD 

290 BE A GO OR AN0THER LOAD. -■■■■' 

295 CONGO EXECUTES THE JOB UNLESS A FATAL ERROR OCCURS OR THE 

296 • ERROR COUNT EXCEEDS THAT SET BY ERCNT.. 
"y.00 ..' DETECTED DURING LADING 

•505 G0 EXECUTES THE JOB ONLY IE NO ERRORS OCCURRED- DURI MG 

310 LOADING. • 

315 . •' . . • ' 

320 3. SET MEMORY OPTIONS 

325 ' 

330.' SET N SETS ALLOCATED MEMORY TO OCTAL PATTERN SPECIFIED . 

335. . BY N (MEMORY IS NORMALLY SET T0 ZERO). 

340 

345 4. SET MAXIMUM ERROR C0UNT 
•350 

355.. ERCNT N SETS A LIMIT (N) 0N THE NUMBER OF FATAL AND N0NFATAL 

360 -ERROR MESSAGES WHICH MAY BE PRINTED BEFORE L0ADING 

365 • IS ABORTED - . THIS COUNT IS NORMALLY SET AT 150. 

370 .-■■..•■. 

375 5. SYMREF AND SYMDEF OPTIONS 

3*0 . 

385 NOSREF NO SYMREF'S ARE PRINTED.: THIS IS STANDARD 

390 -SYMREF CAUSES ALL'SYMREF'S FOR A LOADED ROUTINE ■" - 

395 ■ T0 BE PRINTED WITH THE- MEMORY ■ MAP . 

400 NOSDEF N.0 SYMDEF'S WILL 3E -PRINTED; : THIS. IS STANDARD 

405 . SYMDEE SYMDEF 'S WILL BE PRINTED ' WITH -THE MEMORY MAP. ~ 

410 

415 6. LOW COMMON OPTION 

420 

^25 • • LOC0MN CAUSES ALL LABELED COMMON TO BE ASSIGNED BELOW 

^30 .. BLANK COMMON. 

435 * . ' ■ 

440 7. SETUP OPTION 

445 . 

450 ? . . 

455 

460 8. FILE CONTROL BLOCK OPTIONS 

465 ■'■• / . 

470 ■ ? . • 

475 

480 9. SYMBOL TABLE ADDITIONS 

485 

490 USE NAME/SIZE/, N.AME1 ,NAME2 

495 THIS-'PERMITS THE USER 'TO INSTRUCT THE: LOADER TO ENTER THE 

5.00 ' VARIABLE NAME INTO ITS SYMBOL TABLE AS LABELED COMMON 

505 REGIONS -OR SYMREF'S.' SIZE IS GIVEN IF THE VARIABLE IS 

510 '' TO BE USED AS A LABELED COMMON -REGI ON AND REPRESENTS THE 

515 . AMOUNT OF STORAGE TO BE SET ASIDE AT THAT POINT QF LOADING. 

520. ' ^I-F SIZE IS NOT GI VEN NAME • IS CONSIDERED AS A SYMREF. IF 

525 SIZE IS TERMINATED BY THE CHARACTER L (I.E. /200L/) ,' THE 

530. " LABELED COMMON REGION 'NAME IS HANDLED AS IF UNDER THE L0C0MN 

535 OPTION. ALL OTHER LABELED COMMON REGIONS ARE HANDLED " . 

540. NORMALLY. 



-v:; u n i i_. 



5*35 THIS PERMITS LOCATIONS 0F MEW SYMDEF'S ■ T2 BE DEFINED BY 

560 ' SYMDEF'S PREVIOUSLY DEFINED, DEFINING NEW SYMDEF'S . 

565 RELATIVE T0 PREVIOUSLY DEFINED SYMDEF'S, AND EQUATING 

570 'LABELED COMMON REGIONS RELATIVE 10 'BLANK COMMON. 

575 DIFFERENT EQUATES ARE SEPARATED BY COMMAS. 
.580 

^85 EX1 EQUATE NAMEl /NAME2-,NAME3/,NAME4/NAME5/ 
y90 . EX? EQUATE NAME ( 1 0) /NAMED/. " •' 

595 EX3 EQUATE .CMN . /LC 1./, .CMM. (100) /LC2/ 
600 • ■'■.-' 

605 EX1 DEFINES NAME? AND NAME3 AS SYMDEF'S WITH THE EQUIVALENT 
610 ;" ■ LOCATION OF NAME!. A FATAL ERROR RESULTS IF NAME1 IS 

615 UNDEFINED. IF NAMES OR NAMF3 HAVE. BEEN PREVIOUSLY. 

620 . • • DEFINED, THEY ARE REDEFI NED , -AND A NONFATAL ERROR 

'.625 'MESSAGE IS PRINTED.' NAME5 SYMDEF IS DEFINED .AS HAVING 

630 LOCATION EQUIVALENT T0 THAT 0F NAME4. 

635 ' ■ ■ . . 

6^0 : EX2 A NEW- SYMDEF MAY 3E DEFINED RELATIVE TO A PREVIOUSLY 
645 ' DEFINED SYMDEF 3Y ENCLOSING THE INCREMENT' IN PAREN- 

650 '■'■ THESES. .NAMED IS DEFINED AS THE LOCATION NAME+10. 

655 ■ ■' • . \\ .' ■ 

660 EX3 .CMN. IS A STANDARD .SYM30L WHICH IS SYN0NYM0US WITH 
665 THE BEGINNING OF BLANK COMMON. .THE LABELED COMMON- 

670 . REGIONS (LCI AND LC2) ARE EQUATED-TO THE RESPECTIVE 

675' ■■■■' • POSITIONS 0F BLANK C0MM0N. LABELED COMMON REGT0M 

680 • LC2 IS' ASSIGNED AN ADDRESS EQUAL T0 THE BEGINNING- -0F 

685 BLANK COMMON PLUS 100 OCTAL". THE LENGTH 0F BLANK 

690- COMMON IS ADJUSTED ACC0RDINGLY. 

695 
700 CONTINUED IN ML0AD2 



LIS 



ML0AD2 14:06 JUNE 22 , 1966 

6/20/66 (RPL) 

100 M0LD L0ADER (CONTINUED)- 

105 

110 

115 10; H-EM0RY P0SITI0N ' 

120 . • 

125 NORMAL 10ADING PROCEDURE WILL 3E- THE Li3W La AD 0PTI0N . 

130 DESCRIBED IN IKE GEL0AD MANUAL. IN 0RDER 13 SAVE' SPACE . 

135 F0R BLANK C0MM0N IT IS NECESSARY T0 TELL THE L0-ADER. 

MO •" H0W FAR ABOVE THE BASE ADDRESS IT SH0ULD PLACE THE 

145 : FIRST PROGRAM. 

150 ' ; 

155 COMMON N CAUSES THE LOADER 13 SKIP N L3CATI0NS BEF0RE 

160 . LOADING THE FIRST PR0GRAM. 

165 

170 HL0AD WILL CAUSE PROGRAMS T0 3E liJADED STARTING AT THE 

175 • UPPER, END 0F ALLOCATED MEMORY.- . 

ISO 
.185. 11. LIBRARY USE ' 

190 

195 . • THE USER IS ALLOWED 70 SPECIFY CERTAIN FILES WHICH ' 
1200 CONTAIN LIBRARY SUBROUTINES. IF ALL 0F THE SYMREF5 HAVE 

20.5 NOT BEEN DEFINED AT THE END 0F L0ADINQ THE' USERS PR0GRAMS 

210 IKE L0ADER: WILt SEARCH THE UBRARY FILES IHE USER SPECIFIES" 

215 SEARCHING Fm SUBROUTINES THAT HAVE PRIMARY SYMDEF SYMBOLS 

220 . IDENTICAL TO ANY 0F IHE UNDEFINED SYMREF. SYMBOLS IN ITS 

225 . SYMBOL TABLE. THE FILES WILL BE SEARCHED IN THE 0RDER GIVEN 

230 • «' .- 

235 UB N1-,P1; ...; NN S PN 

240 • . 

245- THE i\ T, S ARE NAMES AND THE P 'S . ARE PASSW0RDS . 

250 

255 ■ 12. ENTRY U3CATI0NS • ,' 

260 

265 ENTER NAME SYMDEF ''NAME IS THE T -EESIRED ENTRY POINT T0 THE 

270 ■ " PROGRAM. IF THIS 0PTI0-N IS NOT PRESENT ENTRY 

275 ' .. IS -MADE AT THE FIRST EEFINED PRIMARY SYMDEF 

280 0F THE FIRST PR0GRAM LOADED. - 

285 , 

286 START C0NTR0L WILL BE IRANSFSRED T0 THE PROGRAM' JUST L0ADED 

287 (SEE ENTRY L3ACATI0N 0PTI0NS), 

288 ■ ' ' ' ■ 
290 
29 5 
300 
305 

} 310 
320 
330 

340 EXIT • • 

350 

360 THIS COMMAND WILL CAUSE THE LDADER 10 EXIT "BACK T0 THE 

370. EXECUTIVE. 

380 •■■.■"■ 



IMP XXX ,PPP 




















THIS COMMAND 


WI LL 


.DUMP A CORE 


:■■ I MAG 


E .OF 


A 


PR 


0GRA? 


'I THE 


USER 


HAS- JUST 10 At) ED AND PLACE IT 


IN Fl 


LE XXX 


• 


FILE 


XXX 


•MUST ' 


NOT ALREADY 


EXIST. 


PPP IS A 


PASSW 


0RD 


10 


PU 


T ■'"Mi 
1 xjCi 


'THE 




FILE. 





















LIST 



frc,y<\R 



10:01 : JULY 1, 1966 



100 


tf-ILP C]'A r 


?ACTER 


110 






120 






ilOO 
1 f .<?l 




MOLD 


150 , 






200 . 


000 


MULL 


2*10 


001 ■. 




220 


002 


, 


230 


. 003 




240 


004 . 


. EOT 


250 


005 


EMQ 


260' 


.006 


A OK • 


2 70 


007 


PELL 


2R0 


1 


q o 


290 


on 


•HT •' 


30.0" 


012 


,LF 


310 


013 - 


VT 


520 


01.4 


, w 


330 


.015 


CR 


340 


016 


sa 


350 


017 


SI 


360 


020 ' 


DLE 


3 70 


021 


DC1 


380 


022 


DC2 


390 


• 023 


DCS • 


400 


024 


DC4 


410 


025 


NAK ' 


420 


026 




430 


02 7 




440 


030 


CAW 


450 . 


03 1 - 




455 


032 ' 


. 


460. 


033 


. ESC 


470 


034 




480 • 


035 





MOLD-CHARACTER SET 



500 


03 7 




510 


040 


SPACE 


520 


04 1 


EXCLAMATION 


530 


042 


n 


540 


043 ■ 


# 


550 


04 4 


$ • 


560 


045 • 


PER CENT 


570 


046 


AMPERSAND 


580 


04 7 


AP0STRC1PHE 


590 


- 050 


( 


£00 


051 


) 


620 


052 


sk 


630 


053 


-r ' 


5/< 


054 


9 


650 


055 




660 


056 


• 


670 


057 ' 


/ 


680 


060 





65)0 


06i 


1 


700 


062 





710 


063 


3 


720 


064 


■ ■ 4- 


730 


0^6 5 


5 


74 


066 


6 


750 


' 06 7 


7 


760 


070 


o 

.<■> 


770 


071 


9 


780 


72 


• 


790 


073 


■ • 

5 


800 


74 


< 


810 


075. 


. £ 


•820 


076 


> 


830 


077' 


• "?' 


84 • 


100 


•■ GRAVE - 


850 


*101 ■ 


A 

n 


860 


102 


n 

L > 


870 


. 1 03 


c 


872 


104 


D 


876 


■105 


■E 


878 


106- 


T7 
■ 1 


880 


107 


G 


882 


110 


u 

j i 


884 


• 1 11 


' I 


886 


112 


J 


888 


1 13 


K 


890 . 


1 14 


L 


892 


115 


M 
1 i 


894 


1 16 


M . 



p T 



■S.9S 


120 


D 
1 


.900 


21 




910 j 


22 


D 


09Q 


.23 


s 


922 


/. 

u -1 


T 


9?4 


25 


!J 


926 1 


26 


V 


923 • ■ 1 


27 


W 


**?.* 


30 


X 


930 


L3l 


y 


93?. ] 


32 


7 


93 A 


33 


[ 


93 6 


34 . 


tilde: 


93 R 


[35 


] 


9-0O" " ] 


36 


CIRCUMFLEX 


94?. 


[3 7 


UNDERSCORE 


94 4 .'] 


4 


■ AT SIGN . 


94 6 * J 


4 1 


. A (LOWER CA 


94 7 ] 


.42 


ti ■ ■ 

. ■ 1 1 


94 5 '. ] 


[43 


C 


O/19 


[44 


' D 


950. 


145 


F 


951 • . J 


.46. 


. F ■ . " 


95? ' 1 


4 7 


G 


954 ' 


[50 .. 


H • • 


956 , " 1 


[51 


I " 


957 


[52" 


■ J 


95R 


53 


1/ »» 


959 " 1 


[54 . 


1. 


960 J 


55 


M . . . " 


96 1 


56 


M 


)*£?.■ ■ . , 


.57 


O • " 


'963 


[60 


p 


96 4 • ] 


61 


0. " i 


965 


62 


p . " 


96 6 ] 


63, 


C " 


967 . j 


64 


V • " 


96R 


65 


11 


^69 


^G 


1/ 


970 • '•' 


67 • 


;■■/■ 


97 1 J 


[70 


• X : " 


97? 1 


71 


Y 


973 ■] 


72 


7. 


974 • 3 


73 


LEFT. PRACE 


975 '■' 1 


74 


n\/F.RSCPRE 


976 ] 


75 


.RIGHT PR'ACE 


977 1 


76 


VERTICAL LI 


978' i 


77 


DELETE '. , 
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'.IF 



OLD 

OLD PROBLEM NAME— MISC 

READYo 
LIST 



MISC 

100 

110 

120 

130 
"MO 

150 

160 

170 

180 

190 

200 

210 

220 

23 

240 

250 

260 

270 

272 

274 

276 

280 

290 

300 

310 

320 

330 

340 

350 

360 . 

3 70 

380 • 

3 90 
400 
A 1 
411 

4 12 
4 1 A 
4 16 
420 



.13:30 . JUNE 30, 1966 
JUNE 27, '66 (KML) 
MISCELLANEOUS SYSTEM CONVENTIONS. 
FILE NAMES ' .' 



PASSWORDS 



AS TAR AS THE .EXECUTIVE ' IS CONCERNED FILE NAMES ARE 

COMPOSED OF 2 36-BIT WORDS WHICH MAY HAVE ANY PATTERN 

OF O'S AMD rs. BUT EDITOR, DDT, GMAP, AND 

THE LOADER WILL BE WORKING PRIMARILY WITH "-ASC II 

SO THE FOLLOWING CONVENTION WILL BE ADHERED TO' BY 

THOSE 4 SYSTEMS; • 

NAMES WILL BE 8 CHARACTERS LONG. IF THE NAME SUPPLIED 
IS LESS THAN 8 CHARACTERS A SUFFICIENT NUMBER OF 
BLANKS WILL BE ADDED COM.. THE • RIGHT) TO MAKE THE 
STRING 8 CHARACTERS IN LENGTH, IN OTHER WORDS 
NAMES WILL BE LEFT JUSTIFIED AND BLANK FILLED. 
ALSO THE NAME MUST .NOT HAVE LEADING BLANKS OR 
ONE -OF THE FOLLOWING CHARACTERS IMBEDDED IN THE' 



NAME: 



OR 



IN THE INITIAL VERSION? OF MOLD, PASSWORDS WILL • 
BE ALLOTTED ONLY -If? BITS ' RUT' EDITOR, DDT ' 
ETC, WILL ALLOW UP'TO 5 CHARACTERS- SO SOME MAPPING 
MUST BE APPLIED T0 THE 8 CHARACTERS TO PRODUCE THE 
PASSWORD. THE FOLLOWING MAPPING WILL BE USED; 



ASSUMING THE PASSWORD IS -COMPOSED OF THE 8 CHARACTER, 



CI 'CO- P * 7 T ' ' C M T 1 "7 Ai ^ r\ n T V 1 i , v 'l T C 

1 ? \..t, , „ g o , l-o ]. r iL:V lriL- ALui.V. i i H'.-J ib 



(((((( CC 1 * I -J+C 2 ) * N+ C3 ) * N+ 04 ) * Nf C4 ) * N-r C5# N „ , 
WHERE N IS' EQUAL TO 631463 BASE fV IN ORDER 
TO GET AM 18- BIT RESULT USE THE L<*W ORDER IS 
BITS OF THE RESULT. 

TF NO' PASSWORD >S SUPPLIED' THEM THE VALUE IS 
SUPPLIED AUTOMATICALLY. BY EVERY SYSTEM. 



430 

440 CHARACTER FILES ... 

450 ■ . • 

ago since the -smallest unit the file system is capable 0-F- 

4 70 ■ HANDLING IS A WORD, ALL CHARACTER FILES MUST 

480- * • -CONSIST 0F4*N CHARACTERS (ASSUMING. THERE ARE N WORDS- 

490 IN THE FILE). THERE IS, NO. END OF FILE CHARACTER.. ON. 

500 THE SYSTEMS LEVEL.. THEREFORE CHARACTER ' FILES MUST 

510 BE AUGMENTED TO A" MULTIPLE OF A "CHARACTERS* THE . ■ 

520. ' DELETE CHARACTERCOCTAL 177) SHOULD BE USED AS THE FILL ' 

530 'CHARACTER WHEN.TKE FILE DOES NOT. TURN- OUT TO HAVE EXACTLY 

540 ' 4*N CHARACTERS,, THE FILE CHARACTER WILL ALSO 

550 HAVE TO BE USED WRFN WRITING N WORDS ON A REMOTE ' '■ 

560 CONSOLE, 

570 

500 

590' : TELETYPE I/O 

GOO 

610 INPUT MODES 

630. ' 1 LINE BY LINE CONVERSATIONAL • 

640: ' ' 2 FILE ?UILDIN"G(TWO CARRIAGE' RETURNS , 

650 . IN A R.CH-i CAUSES A RETURN TO LINE BY. LINE ' 

660 CONVERSATIONAL. • • 

670' ' . a EVENTUALLY SYSTEvS WILL BE ABLE' TO SELECT INPUT 

672 ' " ; '• SET ilODE EXECUTIVE. EXECUTIVE CALLo EVENTUALLY 

674 ' THERE WILL RE A". SPECIAL READ CO Ml AMD WHICH WILL 
676 HE USED FAR UNSOLICITED INPUT, UNSOLICITED 

675 .INPUT IS DEFINED AS ANY I NPUT' LINEC~ ; R LINES) WHICH 
6S0' ' ' CHINES IN '.''HEM NO READ C^r^'AND ' IS OUTSTANDING FOR 
6S2 THE FILECRE'NOIE. DEVICE) . THE UNSOLICITED INPUT' 
6M • ■ • . WILL RE GIVEN TO THE FIRST. PROGRAM'' IN THE 

6.S6 - - ' SPAWN TREE WITH A SPECIAL READ OUTSTANDING. 

683 THIS WILL ALLOW THE PROGRAM T0 BE INTERUPTED 

6£0 WITHOUT BEING ABORTED. ■ 

700 " . 

710 PANIC 

7°0 

730 THE BREAK CHARACTER WILL ALWAYS RESULT IN A MOVE 

740 '■ OF ONE LEVEL UPWARD IN THE SPAWN TREE (SPAWNING CAUSES 

750.- • 'MOVEMENT DOWN A LEVEL) . NORMALLY THIS MEANS THE 

760 • l CURRENT JOB IS ABORTED AND THE EXECUTIVE RETURNS 

770 . CONTROL T0 THE ANCESTORAL JOB. 

780 




OLD • . 

OLD PROBLEM NAME — FAULTV 

'READY. 

list; 

■faultv/ ;■ '". 13:15"-' june. 30, 1966 

100 J UN 2 7, 1966 (KML) 
'110 ■ 

120 

140 

150 
' 170 

190 ■■ I.'seFtHE BAR T3~THE MAXIMUM ALLOWABLE LIMITS,. 

200 -2, EXECUTE THE FOLLOWING INSTRUCTIONS.COR THE EQUIVALENT) 

210 STC1' 2*I+B - • -.•■: 

220 • ■: TSS 2*1+1+3- WHERE 0,rl<l6 IS THE NUMBER ASSIGNED T0' 

230 THE FAULT WHICH OCCURRED AND 3 IS THE ABSOLUTE L3C ATIiTiN • 

232 "'OF SLAVE ADDRESS 0,- 

240 ■'•.. , 

270 IF THE JOB IS NOT USING THE CONTROL PROGRAM OPTION THEN THE 

230 FAULT ROUTINE CAN RETURN TO THE POINT 0F INTERUPTI0N BY 

290 EXECUTING A RET 2*1, ■ ■ ■ 

300 , 

310 WARNING: . 

320' • .-■■■"■. 4 

330 • IF THE SAME FAULT OCCURS Iff THE " FAULT HANDLING ROUTINE 

340 Y0U WILL NOT BE ABLE T0 RETURN TO THE ORIGINAL POINT 

350 0F INTERUPTION UNLESS THE. INSTRUCTION COUNTER (CONTENT'S OF 

360. ■*. LOCATION 2*1) HAS BEEN PUSHED ONTO A STACK. 

3-70 

380 

390' 

400 NOTE THAT FAULT IS USED F0R JOB START UP. 

410 THAT IS THE EXECUTIVE WILL' TRANSFER* TO SLAVE LOCATION 

420 ' ONE WHEN STARTING UP A JOB CALLED THROUGH THE 

422 • SPAWN COMMAND. . 

430 



450 . FAULTS AND THEIR SIGNIFICANCE 

4 70, 

480 SHUTDOWN "WILL NEVER BE USED EXECPT AS. THE STARTUP 
490 • OF THE' JOB WHEN THE- EXECUTIVE WILL TRANSFER 

500 , ' CONTROL TO LOCATION 1. 

510' . . •■ 

520 1 MEMORY FAULT' ??, OB ABL.Y • AM. ILLEGAL ADDRESS HAS BEEN USED 
530 • RY THE PROGRAM. 

540 • " ' ' 

550 2 MME THIS IS RETURNED TO THE USER PROGEAK IF THE 

560 LOWER LIMIT OF THE RAR IS MOT EQUAL TO T}[E 

570 ' LOWEST ORDER PlENORY- LOCATION ASSIGNED TO TH1 

580 . •• . JOFi -..."THAT IS THE CONTROL OPTION ALLOWS 

590 . THE C-rs^TR-JL PROGRAM T n PRE-EMPT " ftt-E'S . 

GOO - ...-"'■ 
610 ,3 FAULT TAG 
620 
630 

640 A- TIMER RUNOUT THIS FAULT ODOURS WHEN THE PSEUDS -TIMER 
650 ' .REGISTER RUNSDOWN. 

660 

670 • 5 . COMMAND FAULT ' 
680 

690 • 6 DERAIL 
700 

710 . 7 LOCKUP 
720 ' 

730 8 CONNECT THIS ENTRY HAY EVENTUALLY PE USED TO . 
740 INDICATE THAT A REMOTE CONSOLE (FILE) HAS 

750 ISSUED A CONNECT. 

)760 

770 .9 PARITY 
780 ' . • 

790 10 ILLEGAL OPCODE OPCODE OF ZERO. 
800 

810 11 OPERATION' DOT COMPLETE " - 
820 

830 12 STARTUP'' 
840 • ' 
850 13 OVERFLOW 
060 

870 14 DIVIDE CHECK .. 
880 ■ . 

890 ' 15 EXECUTE 
900 ' ■ 



Structure of: the jo b stack 
At the bottom of the stack is fixed format information that nev?r varies from'.. 
job to job. This contains the account number for billing and pointers used 
to reference file buffers and pointers. It also contains the saved instruct ion 
counter plus indicators and the saved registers * This is where the registers 
arid Indicators are always saved whenever the program is not currently being executed,, 
On top od the fixed locations are the buffers used by the file system* These 
are of variable length so the area must be allocated dynamically. In the first 
implementation the buffers will, all be the same size (the maximum) to simplify the 
design of the file system* There will also be information as to device address , 
amount of buffer filled, link information, and interrupt location? and data 
control word storage,, If a. user calls the exec with a file call that would exceed 
the limits of his state vector, he is immediately swapped out x-zith 'the IC decremented 
by one and the state vector incremented by 1/2 K When he is swapped back in, 
the :3>iE will then be executed again and the file call will then be processed- 
All of this operation is hidden from the user. Memory allocation is done by-' 
the trivial scheme of assigning the next available memory to the next' program «, 
V?heu this runs out of memory because the "next program won't fit 3 the algorithm 
waits 'until the -lowest portion of memory is free and the process starts over 
again. The scheduling algorithm is. done by reference to 2 tables 5 the. run flag 
table and the priority table* One pass is made through the two tables every 
. quantum. end the tables are updated a The program with the highest priority 
tha-i: is ready to run is run. If there is no program ready to run 5 "the .system 
waits until one is read}?* The scheduling. algorithm operates on the- principle 
that if there are n users, each user is entitled to 1/n th of the available 
machine time* Therefore, a user who does a lot of real time input with very 
little calculating will get fast response time while a user who requires a great 
deal of machine time will not delay the system for the other users but will still 
get his share of the computer « The algorithm is designed so that the priority 
of a program increases exponentially to one when the program is not being run 
and decreases exponentially to zero when it is being .run a Therefore, the 
priority represents a. weighted average of the past usage of the computer by the 
program and can be used as an indication of program priorit3/ by the scheduling 

algorithm. 
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Executive function: 



The executive is the section of code that is permanently in core and performs 
x Amct'6ns such as scheduling and memory allocation,' These functions that' enable 
time sharing to function are invisible to the user program and the user can write 
his routines with the assumption that he is the. only one using the machiae<> Of . 
course, the user must adhere to certain conventions or he cannot take full advantage 
of the system.. All I/O must be done through the file system,, No I/O can refer 
to a specific device or use a specific device address, . The available calls on 
the file system nrc given on anothor page* Other cnlls are: 

TIME gives the running time 'in 15«625 usee intervals 

CLOCK gives the time of day in the' \Q in edited BCD format 

3;-i\P- U1TTIL CONDITIO" ' . . . • ' 

causes the program to resume execution only when, the condition 
specified is.. satisfied ■ J 
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causes the BAR to be set inside the user program [used for debugging] 

SET TII'ER causes a timer runout fault at the end of the given execution time 

SPV.Itf causes the execution of a spaced process. communication, between 
processes is by interrupts and file operations „ a file can also 
be set up so a write or a read refers to the other process? 
opened files can also be transfered to the spawned process to use 
as its own. . . . " ' 

TERMINATE causes immediate termination of the process and the incremental 
dumping of files closed[?]and the reassignment of special files 
[teletypes ] 

note: whenever the user sets the base address register to a value thct docs not 
include the fault locations, he immediately gets control of any fault with the base 
address register reset to the original value and he also gets control of ?Z1E faults. 
It is therefore impossible for the program to get out of control by making calls on 
the executive. The onl}/- faults that the user cannot normally get control of are: 
shut down, connect, parity, startup, execute. It is to be noticed that the user 
cannot ignore interrupts with a RET *-l because the stored IC is with respect to 
id: another base address o The SET E'i'.-i call gives the user the option of transfering 
to any slave location with any machine registers and indicators,. Thus a program 
ran be restarted * Thi'- feature is mainly used with debugging* The master file 
directory is keep in memory at all times in [read only storage] with a copy on all 
random access storage devices*. Areas used in swapping arc in the master file dir- 
ectory to minimise the time to find a swap address. All other catalogs are on 
high speed storage. All catalogs with high^ anticipated usage are duplicated to 
guard against errors. If a teletype connected to a user program dissappears, 
this condition is reflected to the user program and all programs related to it. 
All programs for which the teletype user could be billed must terminate in a short 
time (they should preserve themselves for restart) or they will be aborted by the 
Executive. This is to prevent accidental clearing out of a teletype from running 
Ad a lar^e hill. 



Format of a catalog . 
Each catalog entry contains the following information: 

1 name of file or catalog 

2 restriction bits (read permit, temporary file etc) [file or catalog] 

3 naive of trap file or password 

4 dat:e of last modification (or incremental .dump tape number, or date). 

5 statistical information (usage etc,) 

6 device address 

Links have a different format but since they x-;ill not be implemented ..soon no 
detailed format information is given* 

There is n bit that x^ill prevent the coded date and statistical information from 
being updated so that often used catalogs will not have to constantly be rewritten 
back onto the drum or disk.. .This bit cannot be set by the system? but is initially 
placed on the master file directory and all other directories that are oft-h used 
and never dumped because of inactivity/ 



Status returns of the file system 

Unless the call to the file system is in error' (wrong formal etc.) the 
file system will return immediately without any information except that the . 
call was accepted „ '■.lien the file system completes its task , it. will interrupt 
the user program* The status returns of the completed operation cannot be 
transmitted through the registers because they will contain the uset-s 
registers at tl\c time of the interrupt* The status returns cannot be stored, 
.in a standard location because of the possibility of simultaneous interrupts- 
the file system will therefore store the status return of' the completed operation 
by reference to a standard pointer wordo The file system will store the status 
return 'in the slave location specified by the pointer word 6 - It will then 
refer to the pointer "word with a NOP with an AD modification., . "thus the status 
returns w'ill be stored in a list*, If. the delta specified in the pointer is 
zero, no incrementing will take place and all. status returns will be stored in 
the same location. The user program can either scan the table for the new 
status returns or he car.., at the start of each interrupt routine, pick up the 
status returns w5.th an SD modif ication M£ the. user MtllCurC&i Snlu^Ciu'tiiCi 

Mu^oitua^rvV-Vt I Wlr W> ! W? K I W I V Wr; I rl' ! W \ J ? r9 W? I Y9YTO ! I K 4 W3 - n always 
pick up the status return that caused the interrupt «, Think about this for 

awhile to be convinced that this is true* It is based mainly on the fact that 

the last interrupt to take place is the first one initiated <, Interrupts' do not 

have to be Inhibited before the status return is loaded* It is not known yet 

whether the status return will take up one word or two but user programs should 

assume two status returns words. These statuses will inform the user whether any 

unusual conditions were detected on the previous command. It will also contain 

the information as to the number of words read if the operation was terminated by 

an end of record or an end of file. Example of a file copying, routine: 

Ml files are assumed to be opened* 

.This routine copies file 1 into file 2. 

Error detection and end of file handling is omitted 

File 1 interrupt routine: S!£S r s--v'Si 

TRA intl 



intl : ^ SREG regl 

LD*0 status, ££ . 

Tl-fjC end chic 

WRITE 2 5 i2,m 3 n i2 is the 2nd interrupt location 

LREG regl 

RET il 



File 2 interrupt rout ine: ~^Z£^*sil- T ?^l-- ' 

_TRA int2 
int2: 



SREG 


reg2 


LD.\Q' 


status , SD 


TMI 


check 


READ 


l,il 9 m,Ti 


LREG 


reg2 


RET 


l2 



This interrupt routine could be buffered with little additional effort* 
IJotici that the status return is loaded once as a' part of both interrupt 
routines. In this example only one file operation is in progress at any 
given instant "but the presence of other file- activities would not affect the 
operation of these routines. Even with the simultaneous operation of several 
file operations, it is unnecessary (and usless) to set the inhibit bit on in 
the interrupt routines. Several interrupts may take place simultaneously and 
the user must exit the interrupt routine normally (RET) or interrupts will be lost 



Trancing the user and s tatus returns 

• 'fliencver the I/O interrupt routine is being executed, all programs currently 
in memory have all of their registers and indicators stored in a standard place 
in the program header <, when the I/O interrupt routine wants to trap a user 
program, it- loads the saved instruction counter and indicators for the program 
and stores it in the location trap « It then stores the location -of trap *!' in 
the saved instruction counter location. The ef f ect of this is that when the 
program is .restored it will execute the instruction in location trap -:-! with all 
indicators and registers unchanged The program can ignore the Interrupt by- 
placing 'a II ET *-l in t rap 4-1 c Under no circumstances should a. user specify the 
same trap location, for more than one operation* If he does-, there is a chance 
that the program may never leave the interrupt routine as several simulated traps 
may occur at the same time* If two traps occur at nearly the same time, the' 
second user interrupt routine will be executed first- The word that is. stored 
in location trap contains . the instruction counter and the indicators. It aig.Q_. 

possible returns are: ^ '.""%/. '/ j. ^ Cf. ^_^- J 

Normal -. no unusual conditions, operation successfully completed ■ 

End of record - an end of record was detected on the last operation. must issue 

another read command to continue, reading the file. ■• " 

End of file - an end of file was detected on. the. last operation, ■ cannot continue 
Error - unrecoverable error* an. attempt will be made to restore the file from 

the dump tape but you lose for now 
Protection violation - Incorrect password or priveleged command 

File not open ~ operation requires file specified to be open for read/write etc. 
Duplicate name - attempt to create two files of the same name 

On a read, the user should wait to be Interrupted before attempting to use 
any of the data read in„ On a write, the user must not change the data until 
he ha.? been interrupted. A copy command can be stopped at any time [somehow j, 
A user should never execute a DIS instruction v If he must wait for the completion 
of a file operation he should execute a call "S'v7AP UNTIL CONDITION" and 'specify 
the conditions that must be met before bej-ijtg continuing., The format of this call 
are unknown but suggestions are welcome* 



Fil e System Calls 
OP EM FOR READING i, trap, name, password 

Search catalog i for name and verify password if any* When-' complete, trap user 
to location trap . • 

OP EI!. FOll APPENDING i, trap, name, password 

Search catalog i for narr.a and verify password , if any e Uhen complete, trap user 
to location trap ♦ 

READ, i, trap, m, n 

from file i 
Read the next n words 5.nto memory location m/and trap user to location trap when done. 

T .^ITE i, trap, m,' n 

Append the next n words from memory location m to file i and trap user to location 
trap when done. ""* 

CLOSE i, trap 

Close file 5. then trap user to location tra p 

CREATE i, trap, name, restrictions , • 

Create an entry of name in catalog i with restricti ons * Open the file for. writing 
and trap user to location trap* 

DESTROY i, trap j name, password 

Delete name in catalog i if password is correct* Then trap user to location t rap . 

CilAI-IGE i, trap, name, password, newname, restrictions 

Search- catalog i for name and verify password if any.. Then change name to newr.ame 
and replace old restrictions by re s trict ions , 

COPY i,3,.n,trap 

Copy file i into file j but not more than n words o Then trap user to location trap * 
This command is designed for use with teletypes by allowing the teletypes to input 
directly into a file without explicit read and write commands <, It \-7ill terminate 
on n words or on an end of record or end of file 
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